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Sec. 1 to 1.1 Change 1: Oct. 11, 1973 
1. Introduction to System Calls 


A system call is a request by a problem program for some function or service to be 
performed by FLOE or by EEA (the resident executive program). The functions available include 
accessing files, communicating with terminal devices and with controllers and controllees, obtaining 
system tables and information, etc. 

You initiate a system call by storing certain information in the first word of your problem 
program (word zero) and performing an exchange jump.! (An exchange jump is a 7600 instruction 
that allows the CPU to switch execution from one program to another: see LTSS-1, Sec. 3.10.) 
The problem program executes a normal exchange exit and FLOE (or EEA) gets control. Thus 
the contents of all machine registers are preserved for any system call, regardless of the number 
of calls in queue for a given problem program (see the section on chained system calls). There 
are no restrictions on the frequency or number of system calls a problem program can issue, 
except for call 04 (This Problem Program is Finished). Charges for a system call are levied based 
on the number of machine cycles required to complete the call. 

The general method of issuing system calls is as follows. You place information about 
the call in word zero of your problem program. One of the things you store in word zero is — 
the address of another word, alpha, that contains further information specifying the nature of 
the system call. In most cases alpha contains a pointer to another word, beta, which is the first 
word in an array. The beta array is used either by you (to provide further information required 
for the call), or by FLOE (to return requested information or error indications), or both. 


1.1 FORMATS 


In order to issue a system call you must set up word zero of your problem program 
in the format shown below (examples of how do do this appear in the next section). Upon 
completion of the system call, FLOE sets word zero to 0. 


Word zero: O00cc ccccc tttta aaaaa 


where: CCCCCCC is used only for chained system calls; ccccccc 
is 0 for normal (non-chained) system calls. See 
Sec. 1.3, below. 


tttt indicates the type of call. If ¢ttt = 1004 or 
1005, FLOE processes the call; otherwise EEA 
processes it. The value of f¢tttt you use will 
depend on the service you want performed. For 
calls to FLOE the value of tttt determines where 
control goes on completion of the call (see word 
alpha, below). 

aaaaaa is the address of word alpha for calls to FLOE. 
For calls to EEA (¢ttt # 1004 or 1005) the 
meaning of aaaaaa varies. See the individual 
calls. You may locate word alpha anywhere in 
small-core memory or large-core memory (SCM 


Ae 
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or LCM), as long as the address aaaaaa does not 
contain more than 18 bits. 


Word alpha contains information to further define the service(s) required from FLOE. You set 
up word alpha in the following format (see the next section for examples): 


Word alpha: ccennr eturn xxxxb bbbbb 


where : CC is a code number that determines which of the 
28 calls to FLOE you are making. Presently cc 
can have any value from 01 to 34 octal. 


nn is certain information required for the call; 
usually the value of nn determines which of 
several options is desired. 


return is an address. Control resumes at return if the 

call is not successfully completed. The value of 
tttt in word zero determines the location at 
which control resumes for successful comple- 
tion, as follows: 

tttt = 1004 Control resumes at return + 1. 

tttt 1005 Control resumes at the location following the 
one from which the exchange was issued. 


XXXX is certain information required for the call. The 
meaning of xxxx differs for different calls. 


bbbbbb is the address of another word, beta, that is the 
first word in an array. You may be required to 
supply additional information to FLOE in the 
beta words, or FLOE may use the beta words 
to return requested information. You may 
usually locate the beta words anywhere in SCM 
or LCM, as you desire. A certain few calls 
require beta in SCM. The format of the beta 
words is described with each individual call. 


FLOE examines all addresses specified in a system call for out-of-bounds references; this 
includes aaaaaa, bbbbbb, ccccccc, and return. If any address is out of bounds, a fatal error results 
(see Sec. 6.2.1). 

Note that alpha and beta are not required to be in the same memory. Some programmers 
commonly locate alpha in SCM and beta in LCM. 


1.22 EXAMPLES OF HOW TO ISSUE A SYSTEM CALL 


In this section we show in detail two ways of issuing a system call in a Fortran program. 
In the first method (the hard way) you must load word zero, word alpha, and the beta word(s) 
with the exact bit structure required to define the service you want FLOE to perform; in addition 
you must issue an exchange jump. The second method (the easy way) exploits ORDERLIB? 
subroutines to do the bit-and-byte manipulations required to issue the call. 
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The specific example we consider is a system call to create a disk file named FILENAME, 
with a length of 10000, words (see the Create call, Sec. 2.1). If a file by this name already 
exists, it is to be destroyed. The file is to be referred to in the program as “‘logical unit 7”’ 
(actually, the number of an IOC, or input/output connector: see Sec. 4.1). See Sec. 2.1 for 
details about the Create system call. | 


The Hard Way. Figure 1 shows the Fortran coding necessary to issue this system call 
the hard way. The first thing that is necessary is to provide access to word zero of the problem 
program. The ABSOLUTE statement in LRLTRAN allows us to specify that the variable ZERO 
is stored in absolute location zero (“absolute”’ is actually a misnomer, since the first word of 
the program is not word O of memory, but is a relative word zero). Another way to access 
word zero of the program, if your program is loaded by LOD,? is to include the statement 


Line _ Numbers to be OR’ed for words 
no. Fortran coding | zero, alpha, and beta 
| ALL INTEGER 
2 ABSOLUTE ZERO (@) 
3 DIMENSION BETA (15) 
4 ZERO = (1905B SHL. 18) 00000 00000 10050 09000] op, 
5 1 .UN. (.LOC. ALPHA) a aaaaa 
6 ALPHA = (1Q1B .SHL. 48) 01919 90000 90000 90000 
7 | .UN. ( (LOC. ERCRE) .SHL. 39) e rcrea 
8 2 .UN. (11B .SHL. 18) 11 ie 
9 3 .UN. (.LOC. BETA) b bbbbb 
10 BETA = 8RFILENAME 
1 BETA (2) = (7B .SHL. 54) 97000 00000 09000 00000] pea. 
12 | UN. (10@Q0@B) | 
13 


CALL Q8EXCH 
(continuation of coding) 


50 ERCRE (coding for error processing) 


Fig. 1. Fortran coding necessary to issue a Create system call the hard way. The column on the 
right indicates how the words ZERO, ALPHA, and BETA are built by the logical union of 
elements. 
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COMMON / GOBCOM / ZERO 


The common block GOBCOM is located at the beginning of all programs loaded by LOD. 

In this example BETA is a 15-word array; the beta array may need to be larger for some 
system calls. | 

In lines 4 and 5 of the figure, word zero is eensinicted. Note that the value of 1005 
for fttt means that control resumes at the location following line 13 if the call is successfully 
completed (and at the statement labeled ERCRE in case of error). The right-hand column in 
Fig. 1 indicates how ZERO is built from the logical union of the entities in lines 4 and 5. 
| Word ALPHA is constructed in lines 6 to 9. The first four octal digits in ALPHA are 
O101, indicating that one file is to be created using the Create system call (call 01). Following 
these digits is the location of the statement labeled ERCRE (represented by ercre in the figure). 
The 11 option (line 8) tells FLOE to destroy a file by the same name, if such a file exists, 
before creating the new file. Finally, the last six octal digits in ALPHA are the address of the 
array BETA. 

| In lines 10 to 12 the BETA array is filled in; only the first two words of BETA are 

needed. The O7 in line 11 means that the file FILENAME will be referred to in the program 
as logical unit 7 (i.e, FILENAME will be associated with input-output connector, or IOC, 
number 7). Line 12 specifies the length of the file. 

The CALL Q8EXCH statement creates the machine instruction for an exchange jump to 
EEA. This instruction is executed (line 13), and FLOE takes control. After the system call is 
successfully completed, control resumes at the statement following line 13. Control resumes at 
ERCRE if any system-call error occurs. 


The Easy Way. A number of subroutines are available that simplify issuing system calls 
and I/O requests. These subroutines, available in the ORDERLIB library,” are described in 
CIC Rept. M-027: FROSTCLICHE | FROSTCALL | FROSTIO.* In brief, FROSTCALL is a 
multiple-entry-point subroutine that can be used to issue calls to FLOE. FROSTIO can be used 
for I/O requests. FROSTCLICHE is a cliche that you can employ in your code; it defines various 
mnemonics to be used with the two routines. | 

Figure 2 shows how much simpler issuing our Create call becomes when we use ACCESS 
(an entry point in FROSTCALL). The COMMON statement, line 1, is not actually necessary 
for this call but is needed for certain other calls issued using FROSTCALL. The call to ACCESS 
in line 2 does all the work for us. The value of 1 in the first argument means we want to 
issue the O1 call to FLOE (Create). The third argument means that FILENAME is to be logical 
unit 7 (IOC number 7), while the value of zero in the next argument specifies that a disk file 
(as opposed to a tape) is to be created. See Ref. 4 for details on the eas sequence, and 
on the other entry points in FROSTCALL. 


1.3 CHAINED SYSTEM CALLS 
FLOE system calls can be chained — that is, an arbitrary number of calls can be performed 


sequentially before control is returned to the program issuing the calls. A chain of calls is initiated 
by setting up word zero with a nonzero c field: 
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Line No. Fortran coding 


l COMMON / FROSTCOM / -INTEGER- ALPHA, BETA (15) 
2 CALL ACCESS (1, 8RFILENAME, 7, 9, 1990@B, ERCRE) 


(continuation of coding) 


50 ERCRE (coding for error processing) 


Fig. 2. Fortran coding to issue a Create system call the easy way, using the entry point ACCESS to 
the ORDERLIB routine FROSTCALL. See Ref. 4 for details on FROSTCALL. 


Word zero: | 000cc ccccc tttta aaaaa 


where: CCCCCCC is the address of the next “zero word’”’ in the 
chain (19 bits maximum). Zero words of calls 
following the first call in a chain can be located 
anywhere in memory, except at location 0 of 
the program. 


Calls in a chain are executed in order until an error occurs, or until a call with a zero c field 
is encountered. If all calls are completed successfully, control resumes at the location retum + 1 
specified in the last call in the chain, or at the next location in the program (depending on 
tttt). In case of an error return on any call in the chain, the processing of the chain is terminated 
and control resumes at the return address of the bad call. 


oa 


Sec. 2 to 2.1 


2.1 CALL 01: CREATE 
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2. Calls to FLOE 


This call (1) reserves space on disk for a hitherto nonexistent set of files, (2) reserves 
input and output units other than disk and teletypewriter for use by this program, and (3) provides 
system services for a problem-program drop file. 


Format: 


Word zero: 


where: 


Word alpha: 


where: 


aadaaa 


01 


nn 


return 


CC 


dd 


bbbbbb 


00000 OOOO00 1004a aaaaa or 00000 00000 1005a aaaaa 


is the address of word alpha. 


Olnnr eturn ccddb bbbbb 


dd 
dd 
dd 
dd 


dd 


is the code for Create. 


is the number of _ reservation § requests 
(nn < 16). 


is the return address (see Sec. 1). 


is the notify option for tape creates. Ifcc > OO 
and all tape drives are assigned, the ss field in 
word beta is set (see below) and control resumes 
at return. 


indicates which option is desired: 

normal create. 

Drop-file request (destroy duplicate file option). 
Drop-file request (do not destroy duplicate file 
option). 7 
Create under another user number (only user-1 


can use this option). 


Create file but destroy existing duplicate file. 


is the address of the first word, beta, of the | 
nn reservation requests. 


Definition: The term user-1 is jargon for a system of problem programs 
recognized by FLOE as privileged extensions of itself. The term comes from 
“‘user minus 1,’ or user number 999999, which was the original number 
under which these programs were run; there are now several “user-1” 
numbers. These programs are executed by FLOE when it detects a need 
to run them to process HSP output tape, punched-card output tape, dd80 
output tape, microfilm output tapes, file transport, printer, or card reader 


functions. 
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Word beta: 
(dd = 00,11) 


Word beta + 1: 


(dd = 00,11) 
where: mm 
SS 
tt 
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The name of the disk file or the tape-vault number (ASCII, 
right-justified). For disk files, the name may be up to 10 
characters long, and for tape-vault numbers up to 6 characters. 
If dd = 11 and a file having the given name already exists, the 
existing copy is destroyed and the new file is created as specified, 
if possible, and the existing copy is destroyed. If the new file 
could not be created, the existing copy is not destroyed. 


mmsst tuuxx llwww wwwww 


SS 


So: 


SS 
SS 


ss = 


SS 


SS = 


SS 
SS 
SS 
SS 


SS 


SS 
SS 


SS 


SS 
SS 
SS 
SS 


tt 


| 


tt 
tt 


fis 
| 
se 


i 


07 
11 


is the IOC word designation for this file. 


is filled in (by FLOE) on completion of the 
system call, as follows: 

Normal completion. 

Name duplication, or name not in file index. 
Not enough space. 

Access denied. 

Format or parameter error. 

Operator-initiated tape error (tape not in vault). 
IOC word already in use. 

File index or disk trouble. 

Access code out of range. 

No tape drives available. 

File already exists (dd = Q2). 

FLOE cannot destroy the _ existing file 
(dd = O1,11). 

Drop-file length less than 231 octal (dd = 02). 
Unable to send tape-request message to operator 
telety pewriter. 

File name requested is the same as the name 
of a public or political file (occurs only for 
dd = 03: user-1 creating a file under another 
user number). 

Device not available. 

Online printer unavailable (user-1 only). 
dd80A reserve-reject. 

dd80A not ready. 


is the type of unit: 

Disk. 

Seven-track tape. 
Nine-track tape. 

PDP-10 (user-1 only). 
Card reader (user-1 only). 
Line printer (user-1 only). 
Drum.” 

dd80A. 


* 
The drum is read-write for user-1, and read-only for all other users. 


a7: 
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[ if ct = 00 then wu specifies the disk unit (1 through 14,) on which 
this file is to reside. If the requested disk is full, 
or if wu = OO, the file is assigned to the first 
disk unit that has space available. Upon 
completion of this call, wu indicates the disk 
unit (1 through 14,) on which the file was 
actually created. (This may be different than 
that originally specified.) 
If tt = O1 or tt = O02 then uu specifies the logical tape unit (OO through 47) 
to which the operator assigned the tape. 
xXx Specifies file type. 
xx = 03 File is type data. 
xx = 05 File is execute-only drop file (dd = 01,02). 
il is the protection level. 
WWWWWWwww is the word length for this file. This length is 
examined if and only if ¢t = OO (e., disk). 
Word beta: The name of the drop file. For dd = O1, if the new drop file 
(dd = 01,02) can be created as specified, and there is already a file by the 
given name, the existing file is destroyed. If the new file cannot 
be created, the existing copy is not destroyed. For dd = Q2, if 
a file of the specified name exists, FLOE transfers control to 
the error return. If beta = 00, FLOE generates a recognizable 
and unique ASCII name. 

Word beta + 1: The length at which the drop file is to be created (at least 
(dd = 01,02) 231 octal). If beta + 1 is zero, FLOE generates a length 
| sufficient to contain the calling program. 

If xx # 5, drop file is read-write; if xx = 5, drop file is 
execute-only, but system can write into it. 

Word beta + 2: Binary user number. 

(dd = 03) 

Remarks: 

1. mn is assumed to equal Ol if dd = QO1 or 02. 

2. If dd = OO, the error return is taken if ss > O, and IOC words are not set. 

3. For tt = O1 or tt = 02, the six-character tape-vault number is typed on the operator’s 
teletypewriter. The operator locates the requested tape and makes it available to the 
system. If the first, i.e. leftmost, character of the tape-vault number is an asterisk 

| (*) or a plus (+), the operator will mount a blank write-enabled tape. The plus (+) 
indicates a purple reel ‘is to be used. 

4. If dd = OO, the beta words come in groups of two. Thus, word beta + 2 has the 
same format as word beta, and beta + 3 has the same format as word beta + 1. 
There are 2 X nn beta words in all. 

5. If dd = O1 or 02, the user may specify a disk unit for the drop file as for any 


other create. No IOC word is filled in, as none is required. For any variable not 
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specified, the system completes the appropriate beta or beta + 1 word with the data 
it has generated. Hence, if no name is given, the system places the generated hash 
name in beta. If no length is given, the generated length is placed in beta + 1. Any 
combination of name and length or their nulls may be given. If the system generates 
a name it will use the original file name prefixed with an ASCII +. A random character 
will be generated in the low order character position until the name is unique. The 
name of the calling program is changed to the drop-file name. 
6. Creates are processed in the following order, regardless of the order in which they 
are issued: 
1. Tapes; 
2. Other nondisk equipment; 
3. Disk files. 
7. If the protection level field (//) is zero, the file is created with a protection level 
equal to that of the calling program. | 
8. A file cannot be created via the card reader or file-transport system if it has the 
same name as a system public or user public file. 


2.2 CALL 02: DESTROY 


This call allows the problem program to give up disk files and to release input/output 
devices (other than disk or teletypewriter). In the case of giving up disk space, the disk space 
presently being occupied by the specified set of files is given back to the system for reassignment. 
In addition to releasing the specified items, this call makes it impossible for the requesting problem 
program to communicate with them. 


Format: 
Word zero: | 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaa is the address of word alpha. 
Word alpha O2nnr eturn wwvvb bbbbb 
where: Q2 is the code for Destroy. 
mn | is the number of destroy requests (nn < 16). 
return is the return address (see Sec. 1). 
bbbbbb is the address of the first word, beta, of the 
nn requests. | 
ww = | means make a disk-flaw entry (user-1 only). 
ww = 2 means destroy another user’s file (user-1 
only). 
vy # O means destroy a file that is not open. 
Word beta: _ The name of the disk file or the tape-vault number (ASCII, 


right-justified). 


“Compare Close, Sec. 2.19. 


ron 
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Word beta + 1: mmsst t0000 00000 00000 (ignored if vy # 0) 
(ww # 2) | | 
Word beta + 1: mmsst t0000 OO0Ouu uuuuu 
where: mm is the IOC word for this file. 
SS is filled in (by FLOE) on completion of the 
system call, as follows: 
ss = 00 Normal completion. 
ss = Ql Name not in the file index. 
ss = Q2 The file is opened more than once by the calling 


program, or some other problem program has 
it opened. (The file is not destroyed.) 


ss = Q3 The destroy was not accomplished (wrong IOC 
word or name). 
ss = 04 Format or parameter error. 
ss = QS Access denied (ww = Q2, not user-1). 
ss = 06 Tape-destroy error (wrong name, or void). 
ss = Q7 Disk-map trouble (the file is not destroyed). 
ss = 10 No such user (ww = 01). 
ss = 12 User had no files (ww = 02). 
tt is the type of file. 
tt = OO Disk. 
tt = Ol Any 1/2-in. tape. 
tt = 02 Any 1/2-in. tape. 
tt = 04 PDP-10 (user-1 only). 
tt = O05 Card reader (user-1 only). 
tt = 06 Line printer (user-1 only). 
tt = 11 dd80A. 
uu is the binary user number. 


Remarks: , 
1. Each beta word has the same format as beta. There are nn beta words in all. 
2. If ss > OO the error return is taken, and the IOC words are not erased. 


2.3 CALL 03: OPEN 


This call makes it possible for the requesting problem program to communicate with a 
disk file (or set of disk files) that has been previously created” by the user or is otherwise accessible 
by him. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 OO000 1005a aaaaa 


where: aaaaaa is the address of word alpha. 


“Compare Create, Sec. 2.1. 
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Word alpha O3nnr eturn wwOOb bbbbb 
where: 03 is the code for Open. 
nn | is the number of files requested (nn < 16). 
return is the return address (see Sec. 1). 
ww indicates which option is desired (ww = 00, 01, 
O02, 03, or 04) — see below. 
bbbbbb is the address of the first word, beta, of the 
nn requests. 
Word beta: The name of the disk file (ASCII, right-justified). 
(ww = 00,03) 
Word beta + 1: mmssp auurr tlzzz zzzzz 
(ww = 00) 
where: mm is the IOC designator. 
SS is filled in (by FLOE) on completion of the 
system call, as follows: 
ss = 00 Normal completion (read-write file). 
ss = Ol No name was given, or the given name is not 
in the file index. 
ss = Q2 Normal completion (read-only file). 
ss = Q3 Improper IOC word. 
ss = 04 IOC word is already in use. 
ss = QS Access is denied. 
ss = 06 The potential file-transport user doesn’t exist. 
ss = Q7 Drum-file index is now being searched for this 
file. 
ss = 10 Tried to open an execute-only file, or change 


to an illegal type. 


p indicates whether the file is public or private 
(filled in by FLOE). 

Private file. 

Public file. 

Political file. 


Means file is already open (active) by this or 
some other program. _ | 
uu is filled in (by FLOE) with the number of the 


disk unit (1 through 14. )on which the opened 
file resides. 


So OS ey 
T 
Oo NK OC 


rr specifies the file-protection status. FLOE opens 
the file and sets its type to: 
rr = Ol Read-write. 
rr = Q2 Read-only. 


Hl 
© 
WW 


rr Data. 
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is filled in (by FLOE) with the Upecno status 
of the file, as follows: 

Read-write. 

Read-only. 

Data. 


is filled in (by FLOE) with the protection level: 
Not classified. 

Unclassified. 

PARD (Protect As Restricted Data). 

ADP, or official use only. 

Confidential. 

Secret. 

(Reserved. ) 

System. 


is filled in (by FLOE) with the number of words 
in the opened file. 


Word beta: The name of the disk file (ASCII, right-justified). 


(ww = O01) 


Word beta + 1 mmssp auurr tlzzz 22222 


(ww = 01) 


Same as for ww = 00. 


Word beta + 2: ~ Q0000 00000 OOSff STITT 


| (ww = 01) 
SSSTSET 


Filled in (by FLOE) with the length at which 
the file is to be loaded into the LCM upon the 
first load.” 


Word beta: The name of the disk file (ASCII, right-justified). 


(ww = 02) 


Word beta + 1: | mmssp auurr tlbbb bbbbb 


(ww = 02) 


where: mm, SS, PD, 
a, uu, IY, 
t, 1 


bbbbbbbb 


are all the same as for ww = OO. 


specifies the, binary user number of the file’s 
owner. The field is overwritten by FLOE with 
the file length. 


Word beta +. 2: 00000 O0000 OOFSSf STTTT 


(ww = 02) 


"Ge6 Close call, Sec. 2.19. 


same as for ww = Ol. 


-12- 


LTSS-10 


Edition 5 

Sec. 2.3 to 2.4 Change 1: Oct. 11, 1973 
Word beta: is the same as for ww = OO. 
(ww = Q3) 
Word beta + 1: is the same as for ww = Q2, except the ss field is set to 1 if 
(ww = 03) active IOC count for this file is not zero. 
Word beta + 2: is the same as for ww = Q2. 
(ww = Q3) 
Word beta: is the same as for ww = OO. 
(ww = 04) 
Word beta + 1: is the same as for ww = OO. 
(ww = 04) 
Word beta + 2: 00000 00000 OOSff Sffff 
(ww = 04) 

where: SEALS TET is the first-word address of a sector in which 


a fatal parity or positioning error occurred 
(returned by FLOE). 


Remarks: 


1. The beta words come in groups of two for ww = 00. For ww # 0, the beta words | 
come in groups of three. 

2. The options ww = 02, 03, 04 are restricted to user-1 (system) only. 

3. For ss = O1 and ss > O02, the error return is taken, and the IOC words are not 

set. For ss = OO and ss = O02 the normal return is taken and the IOC words are 

set. 


2.4 CALL 04: THIS PROBLEM PROGRAM IS FINISHED 


This call indicates that this problem program has run to its normal termination point. 
The requesting problem program will not receive any more computer time. As soon as all messages 
originated by it have been delivered to its controller, the problem program is disconnected from 
the system. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 04ddr esume 00000 00000 
where: 04 is the code for this system call. 
dd indicates whether the problem program is to be 
saved: 
dd = 00 Erase the problem program from core but 
preserve its final state in its disk file. 
dd = 01 Erase the problem program from core and disk. 
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resume 


Remarks: 
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is the address at which the PP will start if it 
is to be used again. (This feature may be used 
to automatically initialize a service program.) 


1. This requesting problem program is removed from central memory and stored under 
its executing name in the user’s file index. The last message previously sent by the 
problem program is transmitted to the controller when the controller logs in. When 
the message transmission terminates, ALL DONE is transmitted and the done sequence 
is initiated. Control is not returned to the problem program. The ALL DONE message, 


in octal, is: 


beta = 
beta + | 


407777004 15454004457 
56454077774002040000 


2.5 CALL 05: GIVE FILES TO OTHER USERS 


This call makes it possible for one user to give data or programs to another user. 


Format: 
Word zero: 
where: aaaaaa 
Word alpha: 
where: O5 
nn 
return 
bbbbbb 
Word beta: 
Word beta + |: 
where: Ss 


00000 O0O000 1004a aaaaa or 00000 OO000 1005a aaaaa 


is the address of word alpha. 


OSnnr eturn 0000b bbbbb 


is the code for Give Files. 
is the number of files to be given (nn < 16). 
is the return address (see Sec. 1). 


is the address of the first word, beta, of the 
nn requests. 


The name of the disk file (ASCII, right-justified). 


OOssO OOOxx xxxxx XXXXX 


SS = 


SS 
SS 


SS 
SS 
SS 
SS 


SS 


00 
01 
Q2 


Q3 
04 
O5 
06 


07 


is filled in (by FLOE) on completion of the 
system call, as follows: 

Normal completion. 

File already exists. 

This is a public file name. (A user cannot give 
a file with the same name as that of a public 


file. ) 

File does not exist. 

Incorrect format for user number xx... x. 
User number xx ... x is invalid. 


The file going to user-l1 does not have a 
legitimate output file name. 

There are outstanding IOC’s against this file, so 
it cannot be given. 
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User number xx ... x does not have a high 
enough access control level, or is not a pool 
boss. 

Trying to give an execute-only file to user-1l. 


is the (ASCII) user number to which the file 
is to be given. 


1. The beta words come in groups of two. Thus, word beta + 2 has the same format 
as word beta, and word beta + 3 has the same format as word beta + 1. There 


are 2 X nn beta words in all. 


2. If ss > OO the error return is taken. | 
3. Files scheduled for RJET output should be given to user number OO0Q0002. 


2.6 CALL 06: SEND A MESSAGE TO OR FROM A CONTROL TELETYPEWRITER 


By means of this call, brief messages may be sent to the operator, giving directions, 
additional information, or opinions. A message may also be sent back to a user terminal (user-1 


only ). 
Format: 
Word zero: 
where: aaaaaa 
Word alpha: 
where: 06 
nn 
nn = O00 
nn = 01 
nn = 02 
return 
mm 
bbbbbb 
Word beta: 
(nn = 00,01) 
Word beta: 
(nn = 02) 
Word beta + 1: 
(nn = 02) 


00000 00000 1004a aaaaa or 00000 Q0000 1005a aaaaa 


is the address of word alpha. 


O6nnr eturn OOmmb bbbbb 


is the code for this system call. 


indicates the control teletypewriter desired: 
is the operator’s console teletypewriter. 

is the card-reader teletypewriter (user-1 only). 
is the user terminal (user-1 only). 


is the return address (see Sec. 1). 


is the number of main-frame words containing 
the message (mm < 8). 


is the address of word beta, whose format is 
described below. 


The first word of the mm words containing the message. 


Binary user number of the user receiving the message. 


The first word of the mm words containing the message. 
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Remarks: 
1, The error return is taken if mm = OO or if mm > O8. 
2. For nn = QO2 the beta buffer must be in SCM. 


2.7 CALL 07: GET A SYSTEM TABLE 


This call allows a user to get various file indices, user directory information, and certain 
system tables. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005Sa aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: O7nnr eturn mmmmb bbbbb 
where: 07 is the code for this system call. 
nn indicates which option is desired: 
nn = 0O © Get the public file index. 
nn = Ql Get the private file index. 
nn = Q2 Get the currently active user numbers. 
nn = Q3 Get the user directory and repository table 
entries for the requester’s repository group. 
nn = 04 List the IOC’s of the problem program. 
nn = O05 Return count of users files in the mmmm field. 
nn = 06 Get the pool file index(s) that the user currently 
has active. 
nn = 10 List a FLOE system table. (Beta must be in 
SCM.) 
nn = i] is the same as mn = QO1 except as noted under 
word beta + 1. 
nn = 12 Same as nn # O1 except as noted under word 
beta + 2. | 
nn = 13 Means get the user directory and repository 
table entries for all repository groups. 
nn = 14 Same as nn = 11 except as noted under word 
beta + 2. 
return is the return address (see Sec. 1). 
mmmm is the maximum number of files, user numbers, 
or IOC’s. The buffer length must be at least 
2 X mm for nn = 03, 4 X mm for nn = 03 
and 13, and 3 X mm for nn = 04. 
bbbbbb is the address of the first word, beta, of the 
buffer. 
Word beta: The name of the disk file (ASCII, right-justified) filled in by 
(nn = 00,01,06) FLOE. If the user has put a single, left-justified ASCII character 


in the first beta word, only those file names comprised of 
10 characters and beginning with the specified character are 
listed. The first beta word is overwritten. 

WG: 


Sec. 2.7 


Word beta + 1: 
(nn = 00,01,06) 


where: 
Word beta: 
(nn = 02) 
Word beta + 1: 
(nn = 02) 
Word beta: 
(nn = Q3) 
where: 


Word beta + 1: 
(nn = 03) 


where: 


qq 


ddddddd 


A fA 


aada 


dddddd 
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specifies the domain in which the file exists: 
Private file. 

Public file. 

Political file. 

Pool file. 


is filled in (by FLOE) with the protection status 
of the file. 

Read-write. 

Read-only. 

Data. 

Execute-only. 

Execute-only drop file. 


is a 6-bit field expandable to ffuuuu. 


is a completion bit filled in (by FLOE) for a 
file which exists as a result of a file-transport 
job. 

The file is in transit, or this is not a file-transport 
job. 

The entire file has been received. 

is the disk unit (1 through 14,) on which the 
file resides. 


is the protection level of the file. (See Open call 
Sec. 2.3.) 


is filled in (by FLOE) with the time last 
referenced (microsecond clock shifted right 
24 bits). 

is filled in (by FLOE) with the number of words 
in the file. 


The user number (ASCII, right-justified), filled in by FLOE. 


The user claimed time (integer usec), filled in by FLOE. 


aaaaQ 00000 00000 00000 (user directory) or 


is a pointer to first sector of user’s drum-file 
index. 


is the ASCII group code. 
is the repository group initial time (psec). 


ddddd ddeee eeeee eeeee (user directory) or 


VVVVV 


vrrrr rrrrr rrrrr (repository) 


is the user ID number (binary). 


sie 
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Word beta + 2: 


(nn = Q3) 


where: 


Word beta + 3: 


(nn = Q3) 


where: 


Word beta + 4: 
Word beta: 


(nn = 04) 
Word beta 
(nn = 04) 
Word beta 
(nn = 04) 


Word beta 
(nn = 04) 


Word beta: 


(nn = 10) 


CO & 2.3% 


VV gm Og 
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is the current total priority-weighted charged 
time (sec). 


is the ASCII overhead account designator. 
is the remaining repository group time (usec). 


OOO0O Offf Sffff fffff (user directory) or 


Q0000 Occcc ccccec ccccc (repository) 
is the allowed maximum protection level. 
is the current claimed time (usec). 
is the repository group committed time (usec). 


00000 OO00gg gippp hhhhO (user directory) or 
00000 00000 00000 00000 (repository) 


is the maximum percentage charge against the 
group repository that is allowed to this user. 


is a 3-bit field expandable to xyz: 

x — if nonzero, console access allowed. 

y — if nonzero, reduce disk file ages by 
down time. 


z — if nonzero, user is inhibited from 
using the system. 


is a pointer to the user’s repository entry. 


is the number of disk files owned by this user. 


File pool keys. 
Filled in by FLOE; the first word of IOC number 0. 


Filled in by FLOE; the second word of IOC number 0. 
Filled in by FLOE; the third word of IOC number 0. 
Filled in by FLOE; the first word of IOC number 1, etc.” 


The name of the FLOE table desired (ASCII, nght-justified). 
FLOE overwrites beta with the first table entry. The list of 
acceptable table names follows: 


DB descriptor block table (mmmm = 3600, 9) 
UT user table (mmmm = 2048, 0) 

FILE I file index table (mmmm = 15018, ,) 

DMAP disk map table (mmmm = 2048, 9) 

MISCTB miscellaneous table (mmmm = 192, 9) 
CORTAB _ device correspondence table (mmmm = 32, 0) 


* 
See Appendix C for input/output connector format. 
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PAREC device parity-error table (mmmm = 128, 9) 
FLAW disk flaw table (mmmm = 480, ,) 


TPTB HSP, CRT, dd80 tape ID table (mmmm = 3) 
TTY logged-on teletypewriter table (mmmm = 512, 9) 
LT memory reserve limits (mmmm = 2) 
SY operating system number (mmmm = 1) 
ALT alternator table (mmmm = 60, 9) 

Word beta + |: The number of buffer words (beta words) available. 


(nn = 10) 
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Word beta + |: Same as for nn = Ol, except the d field is filled in by FLOE 
(nn = 11) with the time of origin of the file (microsecond clock shifted 
right 24 bits). 
Word beta + 2: QO0000 O00aa aaauu uuuuu 
(nn = 12, 14) 
where: aaaaa is three 5-bit display code characters represent- 
ing the alpha account designator liable for any 
charges against the file. (See Remark 5.) 
UUUUUUU is the binary user number of the originator of 
the file. (See Remark 5.) 
Remarks: 


1. The beta words come in groups of two (except for nn = 03, 04, and mn = 10, 13). 
Thus, word beta + 2 has the same format as word beta, and word beta + 3 has 
the same format as word beta + 1. There are 2 X mm beta words for nn = OO, 
Ol, and 02; and 4 X mm beta words for nn = Q3, 13, and 3 X mm for nn = 04. 

2. The beta words come in groups of three for nn = 04. Thus, word beta + 3 has 
the same format as word beta (but for IOC number 1), etc. There are 3 X mm 
beta words in all. 

3. For nn = 3 or 13, the format of beta is shown in Fig. 3, (p. 20a). For nn = 13, 
the maximum buffer space required is 8804 words. 

4. For nn = 10, beta must be in SCM. 

5. For nn = 12 or 14, note that the alpha account designator and the originating user 
number remain with a file when it is given away until the recipient opens the file 
the first time. Then, both values are changed to the new owner’s numbers. This remark 
does not pertain when the recipient is a User-1 number, in which case all originating 
identification remains with the file until it is destroyed. 


2.8 CALL 10: GIVE TAPE ACCESS TO CONTROLLEE 


This call gives a controllee access to a tape created by its controller. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 1Onnr eturn rrOOb bbbbb 
where: 10 is the code for Give Tape Access. 
nn is the number of tapes to be given. 
return is the return address (see Sec. 1). 
rr determines controllee access to a controller tape. 
rr = 00 Means give access. 
rr = Ol Means recall access. 
bbbbbb is the address of the first word, beta, of the 


nn tape identifications. 
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where: 


mm 


SS 
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Tape vault number (ASCII, right-justified). 
mmss0 00000 00000 00000 


5s = 
SS = 
SS = 


SS 


SS 


00 
Ol 
02 
03 


04 


is the IOC word for this tape. 


is filled in (by FLOE) on completion of the 
system call, as follows: 

Normal completion. 

Tape not defined. 

Wrong IOC word. 

The controllee already owns a private tape in 
the IOC specified by mm. 

The controllee already owns the tape. 
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User directory 
or entries 
_ (max = 1600 
entries, 
| 5 words /entry) 
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eae 2 ne 
etc, 
|| Repository 
entry (s) 
(max = 200 
entries, 
4 words /entry) 


Fig. 3. Format of beta for nn = 03 or 13, call 07. 
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Remarks: 
1. 


Change 2: Feb. 20, 1974 


The beta words come in groups of two. Thus, word beta + 2 has the same format 
as word beta, and word beta + 3 has the same format as word beta + 1. There 
are 2 X nn beta words in all. 

For ss > OO the error return is taken. 

The controllee gains access to the tape through the same IOC number as the controller 
uses for that tape. The controllee is not allowed to destroy the tape; an ss = 06 
destroy error will be returned if it tries (see Sec. 2.2). 

When a controller gives tape access to its controllee, each controllee initialized by 
that controller will have its appropriate IOC words filled in with the corresponding 
tape information (until the controller destroys the tape). The rr option allows the 
controller to manage access to its tapes. 


2.9 CALL 11: CHANGE FILE NAME, PROGRAM NAME, ACCOUNT NUMBER 


This call allows a user to change the name of a file or program, or to change the account 
number being billed. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: linnr eturn 00005 bbbbb 
where: 11 is the code for this system call. 
nn indicates which option is desired: 
nn = 00 Change file name. 
nn = Ol Change problem name. 
nn = Q2 Change account number. 
nn = Q3 Remove program’s trusted status (no beta 
words). 
return is the return address (see Sec. 1). 
bbbbbb is the address of word beta. 
Word beta: Old file name (ASCII, right-justified). 
(nn = OO) 
Word beta + 1: New file name (ASCII, right-justified). 
(nn = OO) 
Word beta: New program name (ASCII, right-justified). 
(nn = Ql) 
Word beta: ss0OO OOOaa aaaaa aaaaa 
(nn = 02) 
where: AG i G is the new account number (ASCII, 
right-justified). 
SS is filled in (by FLOE) on completion of the 


system call, as follows: 
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ss = QO Normal completion. 
SS 01 Illegitimate new account number. 


Remarks: 


1. The number of beta words varies with the option: two fornn = OO, one fornn = O01 
or Q2. 

2. For nn = OO, the error return is taken if there is a name duplication, i.e., a file 
having the proposed name already exists. For nn = Ql, the error return is taken 
is a disk file, having the same name as the proposed new program name, does not 
already exist. 


2.10 CALL 12: CUT BACK FILE LENGTH 


This call allows a user to shrink the size of a disk file. 


Format: 
Word zero: 00000 OO0000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 12nnr eturn OOOOb bbbbb 
where: 12 is the code for this system call. 
nn indicates the option: 
nn = 00 The file is private. 
nn = Ol The file is another user’s file (only user-1 can 
employ this option). 
bbbbbb is the address of a word, beta, defining the file 
whose length is to be changed. 
Word beta: Name of file (ASCII, right-justified). 
Word beta + |: OOssu uuuuu uOzzz 2z2zzz 
where: ss is filled in (by FLOE) on completion of the 
system call, as follows: 
ss = QO Normal completion. 
ss = Ol The new file length is larger than the old file 
length. 
ss = Q2 The name is not in the file index. 
ss = Q3 The file is opened more than once by the calling 
program or some other problem program has it 
opened. 
ss = 04 New file length is zero. 
ss = O5 Unauthorized user trying to use_ the 
nn = QO1 option. 
ss = 06 Other user number is invalid (mn = 01). 
ZO777 222 is the (user-supplied) length of the new file. The 


system will actually reserve this length rounded 
up to the nearest 1000 (octal). 
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uUuuUuUUUU is the binary user number of the other user 


Remarks: 
Ts 


(user-1 only). 


The error return is taken if ss > OO, and the length adjustment is not made. 


2.11 CALL 13: ADJUST PROGRAM FIELD LENGTH 


This call allows the problem program to change its core memory size in either LCM or 


SCM. 
Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaa is the address of word alpha. 
Word alpha: I3nnr eturn OO00b bbbbb 
where: 13 is the code for this system call. 
nn indicates whether adjustment of large core 
memory (LCM) or small core memory (SCM) 
or both is desired as follows: 
nn = OO Adjust LCM field length. 
nn = Ol Adjust SCM field length. 
nn = Q2 Adjust both LCM and SCM field lengths. 
return is the return address (see Sec. 1). 
bbbbbb is the address of word beta, which contains the 
(integer) size of the program. 
Word beta: LCM program size. 
(nn = OO) 
Word beta: SCM program size. 
(nn = 01) 
Word beta: LCM program size. 
(nn = Q2) 
Word beta + 1: SCM program size. 
(nn = Q2) 
Remarks: 


2 


LCM space may be adjusted either up or down, limited by the size of the disk file 
(that is, the code length must be at least 230, less than its disk-file size), and by 
maximum FLL which its 1,414,520 octal words. 

SCM space may be adjusted either up or down, limited by the large core field length 
(FLL). The small core field length (FLS) must be less than or equal to FLL. FLS 
must also be less than or equal to the available SCM space, currently 
57,328, 9 = 157,760, words. 

If the SCM field length is expanded, the problem program is dumped to LCM and 
then the FLS is increased. 
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2.12 CALL 14: SEND A MESSAGE TO THE CONTROLLER 


This call may be used by a problem program to send a message to its controller. To 
facilitate control between a controllee and its controller, the act of sending a message to a controller 
also suspends the controllee and activates the controller, unless the controller is the teletypewriter. 


Format: 


Word zero: 


where: 


Word alpha: 


where: 


adaaaaa 


14 


nin 


return 


mm 


bbbbbb 


00000 OOO0O0 1004a aaaaa or OOOOO OOOOO 1005a aaaaa 


is the address of word alpha. 


l4nnr eturn OOmmb bbbbb 


nn 


nn 


nn 


nn 


nn 


nn 


nn 


nn 
hn 


06 
15 


is the code for Send a Message to the Controller. 


determines the option to be taken: 

Specifies the replace option described below; see 
Remark 3. 

Specifies the replace option for messages sent 
directly to the teletypewriter. 

Specifies the notify option described in 
Remark 3. 

Specifies the notify option for messages sent 
directly to the teletypewriter. 

Specifies the wait option described in 
Remark 3. 

Specifies the wait option for messages sent 
directly to the teletypewriter. 

Means to send a message to the high-level 
problem program controller, i.e., the problem 
program connected to the _ teletypewriter 
(disregarding its output bypass). 

Is no longer available. See Sec. 2.25. 

Send a message to the controller who is x levels 
above this problem. x is an integer and is in 
beta(1). The message begins in beta(2). If a 
controller does not exist x levels above the 
calling PP the error return is given. If the 
teletypewriter is x levels above the calling PP, 
this option acts like the replace option nn = 12. 


is the return address (see Sec. 1). 


is the number of main-frame words in the 
message. (mm < 64 for  problem-program 
messages. ) 


is the address of word beta, the beginning of 
the message storage area. 
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There are two input message buffers for each problem program: 


@ The buffer for messages from the controller, and 
@ The buffer for messages from the controllee. 


Input messages are released (if they have not been accepted) when the problem 
program voluntarily suspends in a RCV state awaiting a message from controller or 
controllee. The problem program voluntarily suspends in a RCV state when it starts 
up its problem program controller (not teletypewriter) or controllee. There is only 
one output message buffer for the entire controllee chain: The buffer for messages 
for the teletypewriter. 

Input and output messages may exist at the same time in the buffers. No message 
may be longer than 63 words. When a message is sent to the teletypewriter, it is 
divided into blocks of 15 words. If the last block is less than 15 words, a left-adjusted 
end-of-message is added after the last message word. There may be up to 4 distinct 
messages in the output buffer at any one time as long as the 63-word limit is not 
exceeded. Only one message may exist at any one time in the problem program 
input buffers. 

Different things happen to the message depending on whether it is directed to a 
problem program controller or to the teletypewriter. The terms replace, wait, and 
notify used above apply only to messages directed to a teletypewriter that is logged 
out. | 


Case 1: Message is directed to problem program controller: 
The message is always accepted by the system. 
Case 2: Message is directed to the teletypewriter: 


@® Teletypewriter is logged in: 
nn = OO 
EZ The system accepts up to 4 messages (63 words total) 
03 before suspending the PP to disk in an XMT sstate. 


13 
nn = Ol The PP is sent to the error return if there is already a 
10 message in the output buffer. 


® Teletypewriter is logged out (or logged in under another suffix): 


nn = 00 | 
12 The last message sent replaces any existing message in the 
output buffer. 
replace 
nn = Q3 eee 
13 The PP is suspended to disk in an XMT state until the 
gat teletypewriter logs in. 
nn = Ol 
10 The PP is unconditionally sent to the error return. 
notify 
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2.13 CALL 15: START UP CONTROLLEE WITH OR WITHOUT A MESSAGE 


This call may be used by a problem program to send a message to a controllee or to 
start a controllee without a message. Doing either of these things activates the controllee and 
suspends the controller in a RCV state (waiting for a message from controllee). 


cc 


00 


Format: 
. Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: ISnnr eturn ccmmb bbbbb 
where: 1S is the code for Send a Message to the Controllee. 
nn determines the option to ‘be taken: 
nn = QO Normal setting. 
nn = Ql Set this problem program’s input bypass. 
Messages from the controllegy bypass this 
problem program and are given to the controlleg— 
nn = Q2 Set this problem program’s output bypass. 
Messages from the controllef “= bypass _ this 
problem program and are given to the 
controlle¢? 
nn = Q3 Set this problem program’s input and output 
bypass. 
nn 10 Treat the calling program like a read-only file: 
the controller (which may be the teletypewriter) 
of the calling program becomes the controller 
of the calling program’s controllee. Any tapes 
belonging to the calling program become the 
controllee’s tapes. 
nn 1S Send a message to the controllee that is x levels 
below this problem program. x is an integer and 
is stored in beta(1). The message begins in 
beta(2). If a controllee does not exist x levels 
below this PP, the error return is given. 
nn = 20 Start the controllee without a message. 
nn = 21 Like nn = O1, but without a message. 
nn = 22 Like nn = 02, but without a message. 
nn = 23 Like nn = 03, but without a message. 
nn = 30 Like nn = 10, but without a message. 
nn = 40 Like nn = 10, but also causes the controller’s 
drop file to be destroyed. 
nn 50 Like nn = 30, but also causes the controller’s 
drop file to be destroyed. 
return is the return address (see Sec. 1). 
CC is a start-up and error-return option. 


Do not start up this PP if the controllee 
suspends in an RCV state. For nn < 20 or 
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nn = 40, if the controllee already has a message 
from the controller, release it and send the 
- controllee this message. . 
cc = O01 Start up this PP if the controllee suspends in 
an RCV state. For nn < 20 ornn = 40, if the 
controllee already has a message from the 
controller, release it and send the controllee this 
message. 
cc = 10 Do not start up this PP if the controllee 
suspends in an RCV state. For nn < 20 or 
nn = 40, if the controllee already has a message 
from the controller, send control to the error 
return. 
cc = 11 Start up this PP if the controllee suspends in 
an RCV state. For nn < 20 ornn = 40, if the 
controllee already has a message from the 
controller, send control to the error return. 


mm is the number of main-frame words in the 
| | message (mm < 64). 
bbbbbb is the address of word beta, the beginning of 


the message storage area. 


Sending a message causes the system to copy the message from problem program 
core into a system buffer and to start the controllee. 

If the controllee is running and the controller’s input bypass is not set, a message 
from the teletypewriter causes the controllee to be suspended and the controller to 
be started. 

If the controller is running and the controller’s input bypass is set, and a message 
comes in from the teletypewriter, then for cc = OO and O1 the controllee is started 
with the controller’s message and the teletypewriter message is thrown away. If the 
controller starts the controllee with no message, the controllee is started with the 
teletypewriter message. 

For cc = Q1 and 11, if any controllee issues a system call to Get a Message or Get 
Symbols from Controller with the suspend option, and there is no message waiting 


for the controllee, then the next higher level controller problem program whose input 


bypass is not set (and which has a flag indicating it specified the cc = Ql or 
11 option) is started and the controllee is suspended in an RCV state. 


There are three possible reasons for an error return from this call: no controllee 


exists; mm = OO; or an illegal option was specified. 

If (1) the controller is on disk waiting for a message from controllee, and (2) the 
controllee is in a RUN, MEM, or XMT state, and (3) the controllee has a message 
from controller that it has not yet picked up, and (4) a message to controller arrives 
from the teletypewriter: then the controllee is put in an RCV state and the message 
it had not picked up is retained in the system buffer. The controller is put in a 
RUN state. | 
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2.14 CALL 16: GET A MESSAGE FROM THE CONTROLLER 


This call may be used by a problem program to get a message from its controller. If 
a message is waiting, it is delivered to the requesting problem program. If there is no message 
waiting, FLOE examines the nn option field and performs the indicated action. 


Format: 


Word zero: 


where: 


Word alpha: 


where: 


Remark: 


aaadaada 


16 


nn 


return 


mm 


bbbbbb 


00000 OOO00 1004a aaaaa or 00000 OOO00 1005a aaaaa 


is the address of word alpha. 


l6nnr eturn mmO00b bbbbb 


WM 


hn 


nn 


hn 


nn = 
= 07 


An 


00 


01 


02 


03 


06 


is the code for Get a Message from the 
Controller. 


indicates the suspend mode: 

If a message is not ready and waiting at the 
instant this call is given, suspend the problem 
program from core until such time as a message 
is ready. 

If a message is not ready and waiting at the 
instant this call is given, return control to 
location return with the buffer unchanged. 
If there is no message waiting when this call is 
issued, suspend the problem program until a 
message is ready. If there is a message waiting, 
place it in the beta buffer, but do not release 
it from the system buffer. | 
If there is no message waiting, send control to 
return. If there is a message waiting, place it 
in the beta buffer, but do not release it from 
the system buffer. | 

is not available. See Sec. 2.25. 

is not available. See Sec. 2.25. 


is the return address (see Sec. I a 


is the maximum number of main-frame words 


to be delivered as a result of this call. 
(mm < 64 for problem-program messages; if 
mm is zero, a maximum of 63 words may be 
delivered. ) 


is the address of word beta, the beginning of 
the message storage area. 


1. Getting a message causes the system to copy the message from the system buffer 
to the problem-program buffer. No end-of-message is added if the length of the 
message is greater than or equal to the number of words requested. If the message 
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is shorter than the number of words requested, a left-adjusted end-of-message is added 
after the last message word. 


2.15 CALL 17: GET A MESSAGE FROM THE CONTROLLEE 


This call may be used by a problem program to get a message from a controllee. If there 
is a message from controllee, it is delivered to the problem program. If there is no message from 
controllee and the problem program was started because its controllee suspended in a RCV state, 
then a word consisting entirely of 2’s is returned in word beta and the error return is taken. 
In all other cases where there is no message from controllee, minus zero is returned in beta 
and the error return is taken. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 OOO000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: l7nnr eturn mmOQOb bbbbb 
where: [7 | is the code for Get a Message from the 
Controllee. 
nn specifies the option, as follows: 
nn = OO means return the message to the PP buffer and 
release it from the system buffer. 
nn = Q2 means return the message to the PP buffer but 
do not release it from the system buffer. 
return is the return address (see Sec. 1). 
mm is the maximum number of main-frame words 
to be delivered as a result of this call 
(mm < 64). If mm is zero, a maximum of 
63 words may be delivered. 
bbbbbb is the address of word beta, the beginning of 
the message storage area. 
Remarks: 


1. Getting a message causes the system to copy the message from the system buffer 
into the problem program buffer. If the length of the message is greater than or 
equal to the number of words requested, no end-of-message is added. If the message 
length is less than the number of words requested, a left-adjusted end-of-message 
is added after the last message word. 

2. If there is no message from controllee and the problem program was started because 
its controllee suspended in an RCV state, then the error return is taken and a word 
consisting entirely of 2’s is returned: beta = 22222222222222222222. In all other 
cases when there is no message from controllee, the error return is taken and minus 
zero is returned: beta = 77777777777777777777. 

3. For nn = 02, the PP may get the message again. The message is released by the 
system when the PP voluntarily suspends in an RCV state awaiting a message from 
controller or controllee. 
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2.16 CALL 20: GET SYMBOLS FROM THE CONTROLLER 


This call is identical to Get a Message from the Controller, described in Sec. 2.14, except 
that the message is delimited to right-justified symbols (consisting of 10 or fewer characters) 
according to certain rules. The symbols are placed in separate sequential computer words. 


Format: 


Word zero: 


where: 


Word alpha: 


where: 


aadaaa 


20 


nn 


00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 


is the address of word alpha. 


20nnr eturn mmddb bbbbb 


nn 


nn 


hn 


hn 


Kn 


OO 


Ol 


02 


03 


10 


is the code for Get Symbols from the Controller. 


indicates the suspend mode: 

If symbols are not ready and waiting at the 
instant this call is given, the problem program 
is suspended from core until such time as 
symbols are ready. 

If symbols are not ready and waiting at the 
instant this call is given, control is returned to 
location return with the buffer unchanged. 

If there are no symbols waiting when this call 
is issued, the problem program is suspended 
until the symbols are ready. If the symbols are 
ready, they are placed in the beta buffer, but 
are not released from the system buffer. 

If there are no symbols waiting when this call 
is issued, control is sent to return. If the symbols 
are ready, they are placed in the beta buffer, 
but are not released from the system buffer. 
The number of symbols returned is placed in 
the word whose address the user has specified 
in beta (e.g., by the statement BETA = .LOC.I, 
the number of symbols would be returned in 
I). FLOE overwrites beta with the first symbol. 
If the symbols are not ready and waiting at the 
instant this call is given, the problem program 
is suspended from core until such time as the 
symbols are ready. The option nn = 10 does 
not apply to dd = Q2. | 
Place the number of symbols returned in the 
word whose address is specified in beta. 
Overwrite beta with the first symbol. If symbols 
are not ready and waiting at the instant this call | 
is given, return control to location return with 
the buffer unchanged. The option nm = 11 does 
not apply to dd = Q2. 
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nn = 12 Same as nn = Q2 and the number of symbols 
returned is placed in the word whose address 
the user has specified in beta. FLOE overwrites 
beta with the first symbol. 

nn = 13 Same as nn = Q3 and the number of symbols 
returned is placed in the word whose address 
the user has specified in beta. FLOE overwrites 
beta with the’ first symbol. 


return is the return address (see Sec. 1). 


mm — is the maximum number of main-frame words 
to be delivered as a result of this call 
(mm < 64). If mm is zero, a maximum of 
630 words may be delivered. 


dd indicates what characters are to be used as 
symbol delimiters: 
dd = 00 Symbols are delimited by spaces and control 
characters. : 
dd =0Q1l - Symbols are delimited by spaces, control 


characters, comma, period, semicolon, left 
parenthesis, right parenthesis, left bracket, and 
right bracket. 

dd = 02 Symbols are delimited by the characters or 
control characters specified in the beta buffer 
(one delimiter right-adjusted per beta word). 
There can be a maximum of 50 delimiters. Any 
character or control character is allowed. A beta 
word that contains a negative integer ends the 
list. If no delimiters are set (that is, the first 
beta word contains a negative integer), then any 
character not a letter, digit, or period is a 
delimiter (same as dd = Q3). 

dd = 03 Symbols are delimited by any character not a 
letter, a digit, or a period. 

bbbbbb is the address of word beta, the beginning of 

| the message storage area. Each incoming symbol 
is right-justified into a separate word starting at 
word beta. 


Getting symbols causes the system to crack the message into symbols and copy them 
into the problem program core. A delimiter, other than a blank, is stored as a symbol. 
For dd = 00, 01, and 03, blanks are squeezed out. For dd = 02, blanks are squeezed 
out only if set as delimiters. 

For options nn = 10, 11, 12, and 13, FLOE overwrites beta with the first symbol. 
These options are not valid for dd = 02. 
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3. If the number of symbols is greater than or equal to the number of words requested, 
no end-of-message is added. If the number of symbols is less than the number of 
words requested, a right-adjusted end-of-message is added after the last symbol. 


2.17 CALL 21: GET SYMBOLS FROM THE CONTROLLEE 


This call is similar to Get a Message from the Controllee, described in Sec. 2.15, except 
that the message is delimited into right-justified symbols (consisting of 10 or fewer characters) 
according to certain rules. The symbols are placed in separate sequential computer words. 


Format: 


Word zero: 


where: 


Word alpha: 


where: 


aadaadad 


24 


nn 


return 


mm 


dd 


OOO0O0 00000 10044 aaaaa or OOOOO OOOOO 1005a aaaaa 


21 


in 


nN 


nn 


iin 


dd 


dd 


is the address of word alpha. 


nnr eturn mmddb bbbbb 


= 00 


is the code for Get Symbols from _ the 
Controllee. 


indicates the option: 


Symbols are returned into the PP buffer and 
released from the system buffer. 


Like nn = OO, except the message is not 
released from the system buffer. 

The number of symbols returned is placed in 
the word whose address the user has specified 
in beta (e.g., by the statement BETA = .LOC.I, 
the number of symbols would be returned in 
I). FLOE overwrites beta with the first symbol. 
The option nn = 10 does not apply to 
dd = Q2. | 

Like nn = 10, except the message is not 
released from the system buffer. 


is the return address (see Sec. 1). 


is the maximum number of main-frame words 
to be delivered as a result of this call 
(mm < 64). If mm is zero, a maximum of 
630 words may be delivered. 


indicates what characters are to be used as 
symbol delimiters: 

Symbols are delimited by spaces and control 
characters. 

Symbols are delimited by spaces, control 
characters, comma, period, semicolon, left 
parenthesis, right parenthesis, left bracket, and 
right bracket. 
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dd = 02 Symbols are delimited by the characters or 
control characters specified in the beta buffer 
(one delimiter right-adjusted per beta word). 
There can be a maximum of 50 delimiters. Any 
character or control character is allowed. A beta 
word that contains a negative integer ends the 
list. If no delimiters are set (that is, the first 
beta word contains a negative integer), then any 
character not a letter, digit, or period is a 
delimiter (this is the same as dd = Q3). 

dd = 03 Symbols are delimited by any character not a 
letter, a digit, or a period. 


bbbbbb is the address of word beta, the beginning of 
the message storage area. Each incoming symbol 
is right-justified into a separate word starting at 
word beta. 


Remarks: 

1. Getting symbols causes the system to crack the message into symbols and copy them 
into the problem program core. A delimiter, other than a blank, is stored as a symbol. 
For dd = 00, 01, and 03, blanks are squeezed out. For dd = 02, blanks are squeezed 
out only if set as delimiters. 

2. Options nn = 10 and 12 do not apply to option dd = 02. 

3. If there are no symbols from the controllee and the problem program was started 
because its controllee suspended in an RCV state, then the error return is taken 
and a word consisting entirely of 2’s is returned: beta = 22222222222222222222. 
In all other cases when there is no message from controllee, the error return is taken 
and minus zero is returned: beta = 77777777777777777777. 

4. If the number of symbols is greater than or equal to the number of words requested, 
no end-of-message is added. If the number of symbols is less than the number of 
words requested, a right-adjusted end-of-message is added after the last symbol. 


2.18 CALL 22: INITIALIZE OR DISCONNECT A CONTROLLEE 


This call is used by a problem program to initialize another problem program as its 
controllee, or as a stand-alone problem program under a different suffix. This call may also be 
used by a problem program to disconnect a previously initialized controllee. Call 22 also allows 
for executing a controllee from a library file. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 22nnr eturn mpssb bbbbb 
where: Ze is the code for this system call. 
nn indicates the option: 
nn = QO Initialize a controllee. 


-33- 


Sec. 2.18 


return 


m 


SS 


mn 
mn 


nn 


nn 


nn 


nn 


nn 


nn 


Wee es 


22 


30 


32 


WN = © 


LTSS-10 
Edition 5 
Change 2: Feb. 20, 1974 
Disconnect a controllee. 
Initialize a controllee at a priority other than 
the controller’s. (A non-zero time limit must be 
specified.) 
Initialize a controllee and start immediately. 
To initialize a controllee at a priority other than 
the controller’s and start immediately. 
Initialize a controllee and start controllee 
immediately. Start up this problem program if 
the controllee suspends in an RCV state. 
Initialize a controllee at a priority other than 
the controller’s and _ start  controllee 
immediately. Start up this problem program if 
the controllee suspends in an RCV state. (A non- 
zero time limit must be specified.) 
Initialize and start a controllee under another 
suffix. 
Like nn = 30 but at a priority other than that 
of controller. (A nonzero time limit must be 
specified.) 
is the return address (see Sec. 1). 


if nonzero, sets the time-limit-notify option (see 
Remark 9). 


is an input/output bypass option. See Sec. 2.13 
for a discussion of bypasses. 

Set neither bypass. 

Set the controller input bypass. 

Set the controller output bypass. 

Set the controller input and output bypasses. 


contains an error code if the error return is 
taken. The error codes are: 

Normal return. 

Program already has a controllee. 

Too many controllees in chain (maximum of 9 
allowed). 

No name given. 

No file of given name. 

Access denied. 

File is type data. 

FLL size no good. 

Illegal f option (see word beta + 1, below). 
FLL larger than file size. 

Given priority is not floating-point. 

System tables are full. 

No time left for user account. 

Insufficient time in repository for time limit. 
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ss = 16 Illegal suffix. 
ss = 17 Specified suffix is in use. 
bbbbbb is the address of a word, beta, 
containing the name of the problem to 
be started. 
Word beta: Controllee (or library) file name (ASCII, right-justified).(See 
(all options) Remarks 5, 6, and 7.) 
Word beta + 1: fxxxx xxxtt ttttt ttttt 
(all options) 
where: f is a field-length option field (see 


Remarks 5, 6,and 7) or is a library load 
option (see Remark 13). 


XXXXXXX is the size at which to start the 
controllee (or length of load from 
library). 

; re is the time limit for the controllee, in 


usec. If tt = 0, the controllee shares the 
controller’s current time limit. 


Word beta + 2: The floating-point priority to be used for the controllee. 
(yn = 02,12,22,32) If beta + 2 is zero, the controller’s priority is used. If beta 
+2 is a right-justified ASCII S, standby priority is used. 
Word beta + 2: Certain information (dependent on the value of f) pertaining 
(nn = 00,10,20) to the size of the controllee (see Remarks 5,6,and 7). 
Word beta +3: Certain information (dependent on the value of f) pertaining 
(nn = 02,12,22) to the size of the controllee (see Remarks 5,6, and 7). 
Word beta + 2: sskkOQ 00000 OOOO! JIIII 
(nn = 30) 
where: SS is the other suffix (integers 01 to 05 
for suffixes A to E). 
kk is the word count of the message to be 
sent. If kk = 0, no message is assumed 
(1111 is the FLS (see Remark 5). 
For nn = 30 the message text is assumed to follow word beta + 2 immediately. 
Word beta + 3: sskkQ 00000 OOOO! JIlll 
(nn = 32) 
where: ss, kk, and I/lllll are the same as in beta 
5 ee 
For nn = 32 the message text is assumed to follow word beta +3 immediately. 
Remarks: 
l. Options nn = 00,02,10,12,20, and 22 are in error if a controllee is already present. 


Option nn = Q1 is in error if no such controller is present. 
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Setting the time limit in beta + 1 does not affect the priority of the controllee. 
For options mm = 02, 12, 22, or 32 the error return is taken if beta + 2 is not 
floating-point, is negative, or has an exponent field of 1777 or 3777. 


If nn = 00 or nn = 02, the controller must send a message to the controllee to 
start it. If nm = 10, 12, 20, or 22, the controller is dumped to disk and the controllee 
is started without a message. 


Word beta + 2 for nn = OO, 10, or 20, and word beta + 3 for nn = 02, 12, or 
22, have the same format, as described here. 

a. If f = O and xxxxxxx = O, the large-core size is taken as the disk-file size. 
Large-core field length is disk size minus 230 (octal). Small-core size and 
field length are taken from information in the exchange package in the 
disk file. If the load size has been previously specified as being different 
from the disk-file size, the specified load size preempts the disk-file for 
large-core field length. 

b. ff = O and xxxxxxx # OQ, large core field length is taken from the x field 
in beta + 1. Large-core size is x plus 230 (octal). Small-core size and field 
length are taken from information in the exchange package in the disk 
file. | 

c. If f = 1, large-core size are taken as the disk-file size. Large-core field length 
is disk size minus 230 (octal). Small-core field length is taken from the 
x field in beta + 1. 

d. If f = 2, large-core field length and small-core field length are taken from 
the x field in beta + 1 and are equal. Large-core size is x plus 230 (octal). 

e. If f = 3, large-core field length is taken from the x field in beta + 1. 
Large-core size is x plus 230 (octal). Small-core field length is taken from 
the low-order 18 bits of beta + 2. 


f. If f = 4, beta + 1 or beta + 2 has the format 
QO000 OOccc ccccO OOOOOD. 


The cccccc field specifies the disk address from which the system will begin 
loading the controllee. The large-core field length and small-core field 
length will be taken from the exchange package. (See Remark 13.) 


For f = O, 2, or 3, the large-core field length, specified in x, must be less than 
or equal to the disk-file size minus 230 (octal). 
For f = 4 and nn = 30 or 32, beta + 2 or beta + 3 has the format 


sskkO OOeccc ccccO OOOOOD. 


The cccccc field specifies the disk address from which the system will begin loading 
the controllee. The large-core field length and small-core field length will be taken 
from the exchange package. (See Remark 13.) 

For nn = 20 and 22, if the controllee issues a Get a Message or a Get Symbols 
from Controller system call (Call 16 or 20) and there is no message waiting, then 
the next higher level controller problem program whose input bypass is not set 
(and which also has a flag indicating it specified the mn = 20 or 22 option) is 
started and the controllee is suspended in an RCV state. 

If field m is nonzero, the controller problem program is notified when the 
controllee’s time limit has been exhausted. The controllee is not terminated and 


Ge 


Sec. 2.18 


‘ee 


EZ. 


LTSS-10 
Edition 5 


remains connected to the controller in an RCV state. The notification message 
sent to the controller program has the octal format: 


word 1: 40777 76454 00457 Q5041 

word 2: 65636 44544 00465 76200 

word 3: controllee name 

word 4: 40777 74002 04000 OO0000 

Options nn = 30 or 32 allow the usual field length, priority, and time specifications 
plus the ability to send the initialized controllee one startup message. Under the 
specified suffix the newly initialized controllee is connected directly to the 
teletypewriter. It is started immediately upon completion of initialization. Once 
the initial message, if any, has been sent to the new controllee, no further 
communication with it through the operating system is possible. The initiating 
program may have local controllers and/or controllees when making the new call 
and may initiate a local controllee after having initialized and started a controllee 
under another suffix. Note: the p field (bypass option) is ignored for options nn 
= 30 and 32. 

When using mn = 30 or nn = 32, the user must specify a nonzero time limit for 
the job being initialized under the specified suffix. 

For options nn = 30, nn = 32, if there is a program active under the other suffix, 
the error return is taken and ss = 17. If there had been a job under the other 
suffix and it is currently in a termination state, the last message it may have sent 
to its control terminal and its ALL DONE message are released and initialization 
is allowed. 


For options mn = 2, nn = 12, nn = 22, nn = 32, if the new priority is to be 
Standby, the beta word should contain a right-justified ASCII S. 

When f = 4, a problem-program controller can initialize any one of many controllees 
in a program library file. The controller will have to specify the initial address 
and the length of the controllee within the disk file named as the library file. 
All the usual priority and time-limit options will be allowed to coexist with the 
new option. 


The controller will specify the name of the file to be referenced, the address of 
word zero of the program minus words, and a length to be loaded. The operating 
system will use the exchange package in the minus words for FLL and FLS. FLL 
must be less than or equal to the load length minus 230 (octal). Other f field 
options will be disallowed. 


Upon the initial load, the controllee will have the name of the library file and 
all its attributes except size and write access. It is expected that the user will use 
the system drop-file-create call and specify a name in that call. If it becomes 
necessary to drop the controllee to disk and no drop file has been created, the 
controllee will be terminated in memory with no current image preserved on disk. 
Modifying the FLL will not be allowed before the controllee has made a 
drop-file-create call or a program-name-change call. 
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2.19 CALL 23: CLOSE 


This call makes it possible for the requesting problem program to sever its connection 
with a disk file or set of disk files without affecting the status of the files in question (compare 
Destroy, Sec. 2.2). 


Format: 
Word zero: 00000 00000 10042 aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 23nnr eturn OOQOOb bbbbb 
where: 23 is the code for Close. 
nn is the number of files requested (nn < 17). 
return is the return address (see Sec. 1). 
bbbbbb is the address of the first word, beta, of the 
nn requests. 
Word beta: mmrrs_ slltt OOOSf SFfff 
where: mm is the IOC word of the file to be closed. 
rr indicates the read-write status: 
rr = OO No change. 
rr = Ol Make this file a read-only file, starting now. 
rr = Q2 Make this file a read-write file, starting now. 
rr = Q3 Make this file a data file, starting now. 
rr = 04 Make this file an execute-only file, starting now. 
SS is filled in (by FLOE) on completion of the 
system call, as follows: 
ss = 00 Normal completion. 
ss = Ol ff is greater than the disk size minus 
230 (octal), or is zero. 
ss = Q2 The file being closed is no longer in the file 
index, or no name was given. | 
ss = Q3 An improper IOC word was used; no close is 
performed. 
ss = 04 Access was denied. 
ss = 05 Nondisk IOC, no close is performed. 
ll is the load-length option: 
ll = 00 Simple close. 
ll = 01 Install load size (FLL — see the f option, 


below) at which the program is to be loaded 
the first time (19 bits maximum). 


ll = Q2 Remove load size (FLL). 
tt indicates pool file status. This option is 
restricted to authorized pool bosses only. 
tt = 00 No change. 
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tt = Ol Make this a pool file starting now. 

tt = 02 Take away the pool file status starting now. 

SPP is the size (FLL) at which the program is to 


Remarks: 
a 
2: 
3. 


2.20 CALL 


This 


be loaded the first time (19 bits maximum). 


All beta words have the same format as beta. There are nn beta words in all. 
If rr = 02 and the file is public, access is denied. 

For ss = 02, 03, 04, or OS, the rr and /] options are not exercised. For ss = 01 
the LL option is not exercised. 

Upon completion, zeroes are placed in the corresponding IOC words, meaning that 
this file has been removed from the problem program’s list of input/output files. 
This call processes all beta words. If at least one has an ss field equal to 01, 03, 
04, or 05, control is sent to return. 


24: GENERAL PURPOSE 


call allows the requesting problem program to: 


@ Modify its time limit 

@® Get its user identification number and bank account 
@ Change its priority 

® Get its current time limit and priority 

® Get its name 

® Get its controllee’s name 

® Get its controller’s name 

® Change the time limit and priority of its controllees 
® Get its current charges 

® Get its minus words. 

@ Cause its current LCM image to be copied to its disk drop file. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 24nnr eturn uuvvb bbbbb 
where: 24 is the code for this system call. 
nn indicates which option is desired: 
nn = 00 Modify time limit. 
nn = Ql Get user identification number and current bank 
account. 
nn = Q2 Change priority. 
nn = Q3 Get time limit and priority. 
nn = 04 Get program’s time used. 
nn = OS Get the problem program name and field length. 
nn = Q7 Get the problem program name, user number, 


terminal, and suffix. 
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Word beta: 


(nn = OO) 


Word beta 
(nn = OO) 


Word beta: 


(nn = Q1) 


Word beta 
(nn = 01) 


Word beta: 


(nn = Q2) 


Word beta 
(nn = 02) 


Word beta: 


(nn = Q3) 


Word beta 
(nn = Q3) 


+ 


+ 


+ 


+ 
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nn = 10 Get CPU time and I/O time (real, unweighted). 

nn = 11 Get total real CPU time, real system-call CPU 
time, and real I/O time. 

nn = 12 Get user charged time. 

nn = 13 Get descriptor-block dead-start flag. 

nn = 14 Recharge user-1 for user service. 

nn = 15 Get controllee name and field length. 

nn = 22 Change priority and time limit of controllees. 

nn = 25 Get controller name and field length. 

nn = 30 Set file-transport-complete flag in file index. 

nn = 33 Get suffix and account number. 

nn = 34 Get all or part of this problem program’s minus 
words. 

nn = 36 List the problem program names of the 
controllees in this chain starting with the 


controllee connected to the teletypewniter. 


contains the number of words in beta (supplied 
by the user). 


is the position of the calling program in the 
chain (returned by FLOE). 


is the return address (see Sec. 1). 


is the address of a word, beta, whose format 
is described below. 


The new time limit (integer usec), from the problem program. 


The value of the time limit (integer usec) at the time this call 
was made, and prior to installing the new time limit, filled in 
by FLOE. 


The user identification number (ASCII, right-justified), filled in 
by FLOE. 


The current remaining repository time (integer usec), filled in by 
FLOE. | 


The new priority (floating-point), from the problem program. If 
beta = 0, the calling program is immediately dumped to disk; 
its priority is not changed. To change to Standby priority: 
beta = S (the ASCII character S). 

The existing priority (floating-point) at the time this call was 
made, filled in by FLOE. 


The existing time limit (integer usec), filled in by FLOE. 


The existing priority (floating-point), filled in by FLOE. 
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Word beta: 


(nn = 04) 


Word beta + 1: 


(nn = 04) 


Word beta: 


(nn = 05) 


Word beta 
(nn = 05) 


Word beta: 


(nn = 07) 


te he 


where: 


Word beta 
(nn = 07) 


Word beta: 


(nn = 10) 


Word beta 
(nn = 10) 


Word beta: 


(nn = 11) 


Word beta 
(nn = 11) 


Word beta + 2: 


(nn = 11) 


Word beta: 


(nn = 12) 


Word beta: 


(nn = 13) 


Word beta: 


(nn = 14) 


where: 


+ 1: 
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The total priority-unweighted charged time incurred under a suffix 
by the current job chain. 


The priority-unweighted charged time incurred by the calling 
program only. If this program is the highest in the chain (i.e., 
the controller connected to the teletypewriter), the charged time 
represents the total of it and all controllees under the suffix. 


The name under which this program is running (ASCII, 
right-justified), filled in by FLOE. — 
The large-core field length of this program, filled in by FLOE. 
xxttt tttaa aaaaa aaaaa 

is the suffix (ASCII, left-justified). 


is the Octopus terminal number in compressed 
8-bit format (returned if the user is logged in). 


is the user number (ASCII, right-justified). 
The program name (ASCII, right-justified), filled in by FLOE. 


Real, unweighted CPU time used (integer psec). 

Real, unweighted I/O time used (integer usec). 

Total real CPU time used by this program (psec). 

Total real system-call CPU time incurred by eae program (usec). 
Total real I/O time used by this program, including load/dump 
I/O charge (usec). 


The user’s current total priority-weighted charged time. 


The descriptor-block dead-start flag, filled in by FLOE. 


O00aa aabbb bbbuu uuuuu 


. a is the binary effort number (blank for 


file transport). 


50 is the ASCII account designator (blank 


for file transport). 


u is the binary user number. 


Aye 


Sec. 2.20 to 2.21 


Word beta + 1: 


(nn = 14) 
where: 

Word beta: 

(nn = 15) 
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lidit lit CCCCC CCCCC 


| rs | is the I/O charge (blank if file transport). 
CO ad. oi€ is the CPU charge (blank if file transport). 


The controllee name (ASCII, right-justified), filled in by FLOE. 
(If no controllee, error return is taken.) 
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Word beta 
(nn = 15) 


Word beta: 


(nn = 22) 


Word beta + 1: 
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The controllee large-core field length, filled in by FLOE. 


The new priority (floating-point) at which the problem program 
and its controllees are to run, from the problem program. If 
beta = O no change is effected. To change to Standby priority: 
beta = S (the ASCII character S). 


The new time limit (integer usec) at which controllees are to be 


(nn = 22) run, from the problem program. 
Word beta: The controller name (ASCII, right-justified), filled in by FLOE. 
(nn = 25) (If no controller, error return is taken.) 
Word beta + 1 The controller large-core field length, filled in by FLOE. 
(nn = 25) 
Word beta: A disk-file name (ASCII, right-justified). 
(nn = 30) 
Word beta + 1 A user identification number (binary). 
(nn = 30) 
Word beta: xxecs sQQaa aaaaa aaaaa 
(nn = 33) 
where: xx contains the ASCII code for the suffix under 
which the calling program is executing (if the 
teletypewriter is logged in with the same suffix), 
or zero. 
aa contains the ASCII code for the account number 
to which this job is being charged. 
SS is the ASCII suffix under which the job is 
running. 
CC is the access code (octal integer). 
Word beta: 00000 OOsss OOOOO OOOII (stored by the program) 
(nn = 34) 
where: SSS is starting address. 
ill is length. 
Word beta + |: The minus words are stored by FLOE beginning here. 
(nn = 34) 
Remarks: 

1. Option mn = 02 causes the problem program to be dumped to disk and queued for 
reload at the new priority. If beta = O no priority change occurs; this artifice can 
be used to force an update of a program on its disk drop file. 

2. The error return is taken for nn > 03 if the new priority is not a positive 


floating-point number, or if the new priority has an exponent field of 1777 or 3777, 
unless the new priority is Standby. 
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For nn = 13 the descriptor-block dead-start flag is reset to 0 upon completion of 
the call. The dead-start flag is set to 1 in each descriptor block describing a program 
that is to be resurrected after the dead start. This provides a means to determine 
if a dead start occurred during the execution of a program. 

The nn = 30 call is used by the FLOE system file-transport routine to turn on the 
file-complete bit (see Sec. 2.7) in the file index for the file named in word beta. 


For nn = 34, the beta buffer must be entirely in SCM. Also, sss + Ill must be less 


_ than equal to 230,. 


For nn = 36, if the number of controllees in the chain is less than uu, the remaining 
beta words are cleared. 


2.21 CALL 25: SUSPEND AND AUTOMATICALLY RESTART 


This call suspends the problem program issuing the call and automatically restarts it at 


a later time. 
Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 25nnr eturn 00005 bbbbb 
where: 25 is the code for Suspend and Automatically 
Restart. 
nn specifies the option: 
nn = QO Recall this program after a certain period of 
time. 
nn = QI Recall some other program immediately. 
nn = 02 Recall a program under a specified suffix. 
return is the return address (seé Sec. 1). 
bbbbbb is the address of a word, beta, whose format 
is described below. 
Word beta: Suspend time (integer psec). 
(nn = QO) 
Word beta: Program name (ASCII, right-justified). 
(nn = Ol) 
Word beta: Suffix to be recalled. Integers 1 to 5 correspond to suffixes A 
(nn = Q2) to E. 
Remarks: 
1. The suspend length must be between 15 seconds and 30 minutes. 
2. The error return is taken if the problem program owns a tape. A controllee sharing 
tape access with a controller PP may not suspend. 
3. At the time this call is issued, the job is suspended from all operation for the period 


specified, and is in a SUS state (state = 31). At the end of the suspension period, 
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the job is put into a state = 11 and is eligible to run again. Control is then sent 
to normal return (see Sec. 1). 

4. For mn = O1 all other active suffixes are searched for the program name given in 
beta. If this name is found, and if the program is in state = 31, that program is 
put into a MEM state and hence is eligible to execute. 

5. For nn = Q2, the specified suffix is examined for a suspended program. If there 
is one it is placed in an active state. If there is no program, or if the specified suffix 
is out of range, the error return is taken. 

6. A message from controller or from controllee will awaken the problem program. When 
a problem program is dumped to disk in a SUS state, its messages (if any) are not 
released from the system buffer. a 


2.22 CALL 26: CONTROL MESSAGE BYPASSES 


This call allows a problem program to turn input and/or output bypasses on or off. If 
a problem program’s output bypass is turned off it receives messages generated by its controllee. 
If its output bypass is turned on messages sent by its controllee bypass the problem program 
and go to the next higher controller problem program whose output bypass is turned off. If 
a problem program’s input bypass is turned off it receives messages generated by its controller. 
If its input bypass is turned on, messages sent by its controller bypass the problem program 
and go to the next lower controllee whose input bypass is turned Off. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 26nnr eturn jjmmQ 00000 
where: 26 is the code for this system calls. 
nn determines the type of bypass: 
nn = Ql Input bypass. 
nn = Q2 Output bypass. 
nn = 03 Both input and output bypasses. 
return is the return address (see Sec. 1). 
Ij determines the nature of the request: 
ji = 00 Turn off bypass. 
jj = Ol Turn on bypass. 
mm stands for problem program, controller, or 
controllee: 
mm = Q1 Problem program. 
mm = 02 Controllee. 
mm = Q3 Controller. 
Remarks: 


1. If mm = 02 and there is no controllee, or if mm = 03 and there is no controller, 
control is sent to return. 
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2.  Fornn = OQ1 or 03, and mm = Q1 or 02, if the problem program whose input bypass 
is being set does not have a controllee, then control is sent to return. 

3. The controller’s input and output bypasses are turned off when its controllee 
terminates or is disconnected. 


2.23 CALL 27: GET A CLOCK READING 


This call allows a problem program to get the value of the 7600 microsecond clock or 
the LLL master clock. 
Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 27nnr eturn OOmmb bbbbb 
where: pa is the code for this system call. 


nn determines which clock: 
nn = 0O Microsecond clock. 
nn 01 LLL master clock. 


return is the return address (see Sec. 1). 


mm indicates the format for the LLL master clock. 
mm = 00 means return the LLL master clock in beta in 

the format given in Remark 1. 
mm = Ql means return the LLL master clock in beta in 

the format given in Remark 2. 


bbbbbb is the address of a word, beta, in which clock 
time is placed. 
Remarks: 
1. The format of the LLL master clock (in bits) is 


where: c= l means the clock is changing. 
nnnnn is months. 
dddddd is days. 
hhhhhh is hours. 
mm ...m_ is minutes. 
SS sce is seconds. 
| re is milliseconds. 
p=c means power failure. 
liliii is ASCII machine identification (R, S, T, or U). 


Except for the machine designation and the c and p bits, these bits contain a modified 
form of BCD. Each group of 4 bits, counting from right to left, can contain the 
values 0000 (zero) to 1001 (nine). 
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2. The ASCII (left-adjusted) format of the LLL master clock occupies beta and beta + 1, 
as follows: 
beta = hh.mm.ss00 
where: hh is hours. 
mm is minutes. 
SS is seconds. 


beta + 1 = xmm/dd/yy0 
where: x is the machine designation. 
mm is the month. 
dd is the day. 
yy is the year. 


2.24 CALL 30: MODIFY SYSTEM USER DIRECTORY (RESTRICTED USE) 


This call allows the modification of the bank account of an existing user number, the 
addition to the user directory of a new user number, the deletion of a user number from the 
user directory, the update of effort-account tables, or the donation of time from pool to pool. 
Its use is restricted. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 30nnr eturn mmmmb bbbbb 
where: 30 is the code for Modify System User Directory. 
nn is the option field: 
nn = 00 Modify the existing mm bank accounts, or add 
if they are not already in the user directory. 
nn = Ql Add the mm new accounts. 
nn = Q2 Delete the mm existing accounts. 
nn = Q3 Donate from one pool to another. 
nn = 04 Access control update. 
nn = Q5 Access control update. 
nn = 06 Access control update. 
nn = 10 Install effort account tables. 
return is the return address (see Sec. 1). 
mmnmm is the number of accounts to be processed by 
this call. 
bbbbbb is the address of a word, beta, whose format 
is described below. 
Word beta: (binary) sssss Sfitr ylllc ceccc cpddd ddddd ddddd ddddd 
uuuUuu UUuUuUUu UUuUUU UUUUU 
where: SS ee aus is the error code, filled in by FLOE on comple- 


tion of the system call as follows: 
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ss = 00 Normal completion. 
ss = Ol Program is trying to add a user number which 
is already there. 
ss = 02 There is a group code mismatch on an update. 
ss = Q3 There is no such user number to update, or the 
user directory is full when trying to add a new 
number. 
ss = 04 User directory is full when trying to add a new 


number, or repository is full when trying to add 
a new account. 


ss = O05 The percentage ccc is greater than 100. 
ss = 06 Not enough time in donor _ repository 
(nn = Q3). 
ss = Q7 legal nn option. 
‘a is the charged-time reset switch. 
i is the console access switch. 
t is the production-number switch. 
ig is the operation number switch. 
y is the must-use-combination switch. 
ill is the maximum protection level. 
se © is the maximum percentage of the repository 
this user may charge. 
p is the repository sentinel: 
p= 0 User number. 
p= 1 Repository. 
dddddd is the ASCII group code. 
UUUUUUU is the binary user number. 
Word beta + 1: ifp=0: isa 60-bit list of file-pool access keys. 
(nn = 00,01) ifp=1: xvvvy vvzzzZ 72ZZ2ZZ ZZZzZzZ 
x is a three-bit field, the last bit of which is not 


used: ab-. Bit a is the over-subscription prevent 
option. If set, the repository is examined for 
available time as each job is initialized. 


Bit b, if set, indicates that bit a only is to be 
stored in the particular repository. All other 
fields are ignored. 


OV ee D is the divisional overhead account code 
(alphabetic portion only) given in ASCII (three 
characters maximum). 


Ze 2. ane Z is the bank account quantity, in psec to be 
stored into the repository. 
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Remarks: 

1. If ss = 00 control goes to return + 1; if ss # O00 control resumes at return. 

2. This is a restricted call; it is accepted only from certain programs known to the 
FLOE system. Any program not having the required qualifications is given the error 
return. 

3. Word beta + 1 is not used for nn = Q2. 

4. For nn = O00, the first 15 beta words should be formatted as follows: 

beta: Time of bank update. 
betatl|: Bank name. 
betat2: Minimum priority (floating point). 
betat3: ddddd ccccc 00000 wwwww 
where: ddddd is the do-not-disturb factor. 
CCCCC is the channel charge factor. 
00000 is the read-only file lifetime (usec /224) 
WWWWW is the read-write file lifetime (usec/224) 
betat4: Maximum priority (floating point). 
betats: Standby priority (floating point). 
betat6: LCM residence charge factor (floating point). 
betat7 CPU use charge factor (floating point). 
betat8 nnnnn nnnnn ppppp ppppp 
where: mn...n is a null field. 
pp... p is the maximum PP LCM size (.e., FLL+230g). 
beta+9 through betat+15 are reserved for future use. The actual bank-account 
data begins in betatl6. 

5. For nn = 03 word beta has binary donor repository number. Word beta + 1 has 
binary donee repository number. Word beta + 2 has microsecond donation. 

6. For nn = 10 word beta has “LETRY” for effort table or “NUMRY” for account 


table. Word beta + 1 has length of table following beta + 1. Words beta + 2 and 
following have effort or account tables. 


2.25 CALL 31: SEND A MESSAGE TO DEVICE 


This call may be used by a problem program to send a message to a non-teletypewriter 
device: TMDS, RJET, file transport, etc. 


Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 
Word alpha: 31nnr eturn OOO0b bbbbb 
where: 3] is the code for this system call. 
nn is the suspend option: 
nn = OO If the message cannot be sent at this instant, 


send control to return. 
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Word beta: 


where: 


return 
bbbbbb 


SS 
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If the message cannot be sent at this instant, 
suspend the PP in a state = 44, (TMDS and 
Elephant) or state = 22, (RJET) until the 
message can be sent. 


nn = Ol 


is the return address (see Sec. 1). 


is the address of a word, beta, whose format 
is described below. 


Obssd ddddd mmmmx xxxxx 


is a flag for bits-per-byte: 


b=0 mmmm is in main-frame words. 

b= | mmmm is in 8-bit bytes. 
is filled in by FLOE on completion of the call, 
as follows: 

ss = QO Normal completion. 

ss = Ol The message cannot be sent at this time and 


nn = O00. 
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User is denied access to this device. 
Word-count error. 
is the machine-device identification number (see 
Remark 1). 
is the number of main-frame words (b = Q) or 
8-bit bytes (b = 1) in the message. For b = O, 
mmnmm <S 14 for all except RJET, 
mmmm S512 for RJET. For 5b = 1, 
mmmm S 105 for all except RJET. 
is the address of the beginning of the message. 


16 bits contain message-header type control 


information in the format: flebttttceccccck. 


Sec. 2.5 
ss = 
ss = 
dddddd 
mmmm 
XRXXXX 
Word beta + 1: 
where: f (first bit) 


Remarks: 


I. 


/ (last bit) 
e (error bit) 


b (binary bit) 


tttt (type field) 


CCCCCCC 
(control field) 


k (chain bit) 


identifies this message as the first in a sequence 
of messages. 

identifies this message as the last in a sequence 
of messages. 

is not used on output, and is zeroed by the 
system. 

is a convert flag. if b = O FLOE treats the 
message as a character string and converts it 
from 6-bit to 8-bit ASCII If 5b = 1 FLOE 
treats the message as a binary string and does 
not change it. 

contains type information. It is set by the 
system except for RJET. 

contains control information. It is set by the 
system except for RJET. 


is set by the system. 


The dddddd field, the machine-device identification number, contains 18 bits in the 


format: 


0Ommmmmmmmdddddddd 
where m is machine, d is device. Valid machine-device fields are: 


PDP-10 concentrator for TMDS and file transport. For this 
value of m, d may be: 


(1) m= 20, 


ad 
d 
d 


H 


Ul 


Ul 


| File transport. 
3 TMDS. 
7 TMDS status display (system only). 
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(2) m = 


(user-1 only) 


100, 


120, 
121 


123 


LTSS-10 
Edition 5 


PDP-11 concentrator for RJET. 
PDP-11 collector for RJET. 


12} PDP-8 terminals for RJET. 


For these values of m, d may be: 


a 


d = 


d 
d 


Q Computer. 

1 Printer. 

2 Card reader. 

3 Teletypewriter. : 


2. FLOE neither adds anything to nor deletes any thing from a message to device. 


2.26 CALL 32: GET A MESSAGE FROM DEVICE 


This call may be used by a | problem program to get a Nessaee from a non-teletypewriter 


device: TMDS, RJET, file transport, ete. 


Format: 

Word zero: 
where: 

Word alpha: 


where: 


Word beta: 


where: 


aaadaaa 


32 


An 


return 
bbbbbb 


SS 


00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 


is the address of word alpha. 


32nnr eturn 0000b bbbb 


AN 


hint 


= 00 


Ol 


is the code for this system call. 


is the suspend option. 

If there is no message waiting at this instant, 
send control to return. 

If there is no message waiting at this instant, 
suspend the PP in a PDP state (32, ) until a 
message arrives. 


is the return address (see Sc 1). 


is the address of a word, beta, whose format 
is described below. 


OOssd ddddd mMMMMX XXXXX 


SS 
SS 


SS 


= 00 


Ol 


02 


is filled in by FLOE on i coinpletiog of the call, 

as follows: 

Normal completion. 

There is no message waiting from the 

teletypewriter or non-teletypewriter device and 
= 00. 

Time-out error. No message was returned from 

the PDP-10 within the suspension time. 
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Word beta + 1: 


where: 


ss = 03 


dddddd 


mmmm 


XXXXXX 


LTSS-10 
Edition 5 


Good return: a message has been received from 
the PP’s’ controller. A message from 
non-teletypewriter device may or may not have 
been returned. A nonzero dddddd means a 
message from device was delivered to the PP. 


is the machine-device identification number 
(filled in by FLOE); see Remark 1. 


is the maximum number of main-frame words 
to be delivered as a result of this call. 


is the address of the beginning of the 
message-buffer area. 


wwwww wwwww OO0OOr vrvry 


ww... WwW 


VYVVVY 


f (first bit) 


/ (last bit) 


e (error bit) 


b (binary bit) 


tttt (type field) 
ceccccec (control field) 
k (chain bit) 


is the suspend time in psec. If no message is 
received from the PDP-10 within the suspension 
time the program is reactivated, the P counter 
is set to return, and the ss field is set to 02. 
w must be 216 sec. If O<. w < 16 sec, FLOE 
uses 16 sec. If w = O, the suspension time is 
taken as 30 minutes. If the w field is filled with 
all 1’s, then the suspension time is taken as 
17.8 minutes. 


the low-order 16 bits on the vy field contain 
type-control information set by the sending 
device in the format: 


flebttttccccccck 


identifies this message as the first in a sequence 
of messages. 


identifies this message as the last in a sequence 
of messages. 


if the message cannot reach its destination, it 
is returned to the sender with the error bit set. 


if b = O the message is a character string and 
FLOE has converted it from 8- to 6-bit ASCII. 
If b = 1 the message is a binary string and 
FLOE has not changed it. 


type information. 
control information. 


if k = 1 the first 48 bits of the first message 
word are treated as an extension of the header. 


=5 |< 
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where: PPPPPP 


nnnn 
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ppppp pnnnn 00000 00000 


is the machine-device identification number 
associated with the next message if there is one 
(filled in by FLOE). 


contains the number of words in the message 
delivered to the PP (filled in by FLOE). 


1. The dddddd field, filled in by FLOE with the machine-device identification number, 
contains 18 bits in the format: 


OOmmmmmmmmndddddddd 


where m is machine, d is device. Valid machine-device fields are: 


(1) m = 20. 


(2) m = 
(user-1 only) 


PDP-10 concentrator for TMDS and file transport. 
For m = 20, d may be: 

d = 1 File transport. 

d = 3 TMDS. 

d = 7 TMDS status display (only). 


100, PDP-11 concentrator for RJET. 
120, PDP-11 collector for RJET. 
121 

2} PDP-8 terminals for RJET. 

123 


For these values of m, d may be: 
d = 0 Computer. 


d = 1 Printer. 
d = 2 Card reader. 
d = 3 Teletyperiter. 


2. FLOE neither adds anything to nor deletes anything from a message from device. 


QO 


It is not possible to receive a message from a user terminal with this call. 


4. If a message from the PDP-10 concentrator (RJET, Elephant) is returned with the 
error bit set, the message “PDP10 DOWN” is returned to the PP: 


beta = 


beta + | 


4077776044602 1200044B 
57675640777740020400B 


The PP gets a good return with ss = 0. 


| 2.27 CALL 33: INTERRUPT CONTROLLEE FOR A MESSAGE OR 
AFTER A TIME INTERVAL | 


This call may be used by a problem program to inform the system whether it does or 
does not want to be interrupted by the arrival of a message from controller, or wants to be 
interrupted after a specified time interval. 
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Format: 
Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: — aaaaaa is the address of word alpha. 
Word alpha: 33nnr eturn OOO0b bbbbb 
where: 33 is the code for this system call. 
nn indicates which option is desired: 
nn = QO Any message from controller will interrupt this 
problem program. 
nn = Ol Only messages preceded by a left-adjusted 
(CTRL-E) I” (40020551B) will interrupt this 
problem program. 
nn = Q2 This problem program does not want to be 
interrupted by the arrival of a message from 
controller. (Cancels previously set TTY 
interrupt. ) 
nn = 10 Interrupt by transferring control to the 
P-counter address in word beta after this PP has 
run At msec (see word beta, below). 
nn = 12 tur off the time interrupt flag. 
return is the return address (see Sec. 1). 
bbbbbb is the address of word beta. 
Word beta: 00000 00000 0000! ZIIll 
(nn = 00,01) 
where: lulll is the interrupt address, the address where the 
problem program is to be started when a 
message arrives from controller. 
Word beta: OOOxx xxxxx OOOO! TIlll 
(nn = 10) 
where: XXXXXKX specifies At in msec (minimum At is 4 msec). 
lilil is the value to which the P counter is to be 
set when the PP is interrupted. 
Remarks: 

1. The Interrupt Controllee system call must be issued again after the problem program 
has been interrupted if the problem program wants to be interrupted by the next 
message from controller. 

2. There will always be a message from controller waiting if the problem program is 
sent to JIIIIl. 

3. The controller interrupt is treated like an I/O interrupt. In order to release the 
controller interrupt the problem must issue the Return from Interrupt system call, 
described in Sec. 3.4. 

4. Fornn = Ol, the (CTRL-E) I is stripped off the message. The message is repositioned 


at the beginning of the word. 


* 
Here (CTRL-E)I represents simultaneously pressing the CTRL and E keys on the teletypewriter, followed by the I key. 
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5. For mn = 10, the time is updated every 3.6 msec. The PP must be running for the 
update to occur. 7 
6. The time interrupt option (mm = 10) must be reissued after each interrupt if the 
PP is to be interrupted after the next At. 
7. To release the time interrupt, the PP must issue the system call Return from Interrupt. 
(See Sec. 3.4.) 
8. For nn = 00 and nn = Ol, the teletypewriter output buffer is cleared at interrupt 


by a message from controller. 


2.28 CALL 34: RUN A SUBORDINATE JOB WITHIN THIS PROBLEM 
PROGRAM'S FIELD LENGTH 


This call can be used to set up a controller-controllee-like relationship within a single 
problem program. It could be useful in a universal controller routine, or any routine in which 
it is desired to reduce the overhead of excessive controller-controllee disk swapping. 


Format: 

Word zero: 00000 00000 1004a aaaaa or 00000 00000 1005a aaaaa 
where: aaaaaa is the address of word alpha. 

Word alpha: 3400r eturn ccssb bbbbb 
where: 34 | is the code to exchange to a new exchange 


package located within the FLS of this PP (this 
PP referred to as main job). 


return is the return address (see Sec. 1). 

CC is the word 1 option: 
cc = 00 The subordinate job’s word 1 is not examined. 
cc = Ol The subordinate job’s word 1 is looked at 


approximately every 3.6 msec, and if it is 
nonzero, the main job is started (it appears to 
the main job that the subordinate job 
exchanged). The system sets 2 high-order bits 
in the subordinate exchange package (word 8). 


SS is an error field, filled in by FLOE (subscript 
m = main job; subscript s = subordinate job). 
See Remark 1 for definitions of LCM, RAS, 
. RAL, FLS, FLL. 
ss = Ql beta is in LCM. 


ss = Q2 RAS, S beta + 16. 
ss = Q3 RAL, < beta + 16. 
ss = 04 FLS, + RAS, > FLS.. 
ss = OS FLL. + RAL, > FLL. 


bbbbbb points to the subordinate job’s 16-word 
exchange package: oe 


P-counter set by the main job; untouched by 
the system. 
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RAS Set by the main job relative to RAS. 
It must be => bbbbbb + 16. The 
system changes RAS. relative to 
absolute machine zero. 


FLS Set by the main job; untouched by 
the system. FLS. must be < FLS_. 
PSD The 4 low-order-mode bits may be set. 


The condition bits are cleared. 
RAL Set by the main job relative to RAS. . 
It must be 2 bbbbbb + 16. The 
system changes RAL, relative to 
absolute machine zero. 
FLL Set by the main job; untouched by 
the system. FLL, must be < oe Bae 


NEA, EEA, and the 2 high-order-mode bits in the PSD are set by the system. The X, B, and 
A registers are unchanged. 


Remarks: 


I. 


Definitions: 

P-counter: program counter. 

RAS: relative address, small core. 

RAL: relative address, large core. 

FLS: field length, small core. 

FLL: field length, large core. 

PSD: program status designator. 

NEA: normal exit address. 

EEA: error exit address. 

Since the RAS. and RAL, are changed by the system, the main job must restore 
this information every time if makes the 34 system call. 

NEA is set to point to the main job’s exchange package. Therefore, the main job 
starts running when the subordinate job issues a normal exchange. 

The system processes error exchanges from both the main job and the subordinate 
job. The main job may regain control by setting minus word 174 and word 2 (see 
Sec. 6.3). 

Information about the subordinate job is stored in minus word 175. Verification 
is made on every load from disk. Fatal error 240 results if the information is not 
correct. 


of = 
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3. Calis to EEA 


A charge of 10 usec will be levied for all calls to EEA. 
3.1 EEA CALL 01: GET A CLOCK READING 


This call allows the user to get the contents of the 7600 real-time clock. 


Format: 
Word zero: 00000 OO0000 uuOla aaaaa 


where: uu indicates which clock is requested: 
uu = Q1 means store the current reading of the 60-bit 
clock in location aaaaaa and transfer control to 
location aaaaaa + |. The 60-bit clock contains 
the number of elapsed microseconds since 
January 1, 1968. 4 
uu = Q2 means store the current reading of the LLL 
master computer clock in location aaaaaa and 
transfer control to location aaaaaa + 1. 


aaaaaa is the address of a particular core location. 
Remarks: 


1. The format for the LLL master clock (in bits) is: 
cnnnnndddddd chhhhhhmmmmm cmmasssssssll cllllllllllp _ 


OOO0O0O0O0Iiiii 

where: c= ] means the clock is changing. 
nnnnn is months. 
dddddd is days. 
hhhhhh is hours. 
mmmmmmmn is minutes. 
SSSSSSS is seconds. 
| or is milliseconds. 
p =e means power failure. 
ilitil is the ASCII character for the machine 


identification (R, S, T, or U). 
2. Except for the machine designation and the c and p bits, these bits contain a modified 
form of BCD (binary-coded decimal). Each group of 4 bits, counting from right to 
left, can contain the values 0000 (0) to 1001 (9). 


3.2 EEA CALL 02: GIVE UP CPU — NEXT TURN 


The requesting problem program will get no more CPU time until the problem program’s 
next turn in the alternator loop. 


25h. 
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Format: 


Word zero: 


00000 00000 0002a aaaaa 


where: aaaaaa is the address where the problem program is to 


Remarks: 
i? 


be restarted. 


The ‘“‘do not disturb” time is decremented by 12 msec. 


3.3 EEA CALL 10: GIVE UP CPU UNTIL I/O COMPLETES 


The requesting problem program will get no more CPU time until each of the specified 
input or output jobs has been completed. There are three options: (1) wait until all input and 
output is complete, (2) wait until a selected input or output is complete, and (3) wait until 
the next input or output request is complete. 

This system call is sometimes called “knowledge of completion,” or KOC. 


Format: 
Word zero: 00000 00000 cc10a aaaaa 
where: CC specifies the type of request: 
ce = 00 Give up the CPU until all input and output 
requests have been completed. | 
cc = nn (1 <nn S 15): Give up the CPU until the input 
or output request specified by those IOD’s 
whose c field (see Table 2 in Sec. 4.5) is equal 
to nn are completed. 
cc = 40 Give up the CPU until the next input or output 
request has been completed. 
aaaaaa is the address where the problem program is to 
be restarted. 
Remarks: 

1. If cc = 00, the problem program is restarted at location aaaaaa when all input and 
output for this program has finished. This call might be used at the end of a problem 
program when the problem program must wait until all output is finished before 
it signals that it has finished. 

2. If cc is a number between 1 and 15 inclusive, and this call is given while at the 
main program level, control is sent to location aaaaaa when all outstanding IOD’s 
with the identification number cc have terminated and the interrupt routine for the 
last such IOD has finished. If no interrupt routine has been specified, control is sent 
to aaaaaa after the I/O jobs in question have been completed. 

3. If cc is a number between 1 and 15 inclusive, and this call is given while in an 
interrupt mode, control is sent to aaaaaa after completion of all IOD’s with 
identification number cc. Interrupts are stacked and processed in the order received. 

4. In both cases described in Remarks 2 and 3, contingent IOD’s with the same cc 


field are considered part of the chain and control is not sent to aaaaaa until they 
have also been completed. 
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5. If cc = 40, the problem program is restarted at location aaaaaa when the very next 
interrupt routine has finished. If no interrupt routine was specified, control is sent 
to aaaaaa after the input/output jobs in question have been completed. If a contingent 
IOD is specified instead of an interrupt routine, EEA picks it up just before 
transferring control to aaaaaa. 


3.4 EEA CALL 20: RETURN FROM AN INTERRUPT ROUTINE 


This call is for use with the FLOE Interrupt Controller system call described in Sec. 2.27 
and with the interrupt options of input/output operations. 


Format: 
Word zero: OOOOO OO0000 cc200 OOO0N 


where: CC specifies the type of request: 

cc = 00 Release the current interrupt and return to the 
zero level at the point of interruption, or take 
the next interrupt in the list. All zero-level 
registers are preserved. 

ce = Ol Release the current interrupt and make this the 
zero level which will be restarted at the location 
following the one from which the exchange to 
issue the call was made. This zero level will be 
started immediately if no additional interrupts 
have been stacked or after the Return from 
Interrupt has been issued for the last interrupt 
in the list. 


Remarks: 
1. If this call is issued while at the main level, the problem program will be terminated 
with fatal error No. 216 (see p. 74). 


3.5 EEA CALL 30: EXCHANGE PACKAGE MANIPULATION 


This call performs the following functions: 


® sets a breakpoint address or step-mode flag, 

® returns the exchange package of the currently executing problem program to the 
problem-program buffer, or 

® stores a specified exchange package into the currently executing problem program. 


Word zero: OOOOO 00000 uwu30a aaaaa 


where: uu indicates the option: 
uu = OO Set the breakpoint address in the exchange 
package if aaaaaa is nonzero. If aaaaaa is zero, 
set the step-mode flag in the PSD register (see 
Appendix E). Control is returned directly to the 
problem on completion of this option. 
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uu = Ql Store the executing exchange package into the 
problem-program buffer beginning at the address 
specified in the low-order 30 bits of word two. 
Control is transferred to word two on 
completion of this option. 

uu = 10 Copy the exchange package located at the 
address specified in the low-order 30 bits of 
word two into the executing problem program 
exchange package. Control is returned to the 
address specified in the P-counter of the new 
exchange package. 


aaaaaa is the breakpoint address if uu = OO. 


For uu = 00, when the problem exits on breakpoint (P = BPA) or step, the step-mode 
and PSD condition flags are cleared, and control is returned to word two. If word 
two is zero execution is terminated with fatal error 232. In this case word zero 
contains 


ccccp ppppp 90000 00000 


where: cccc is the 12 PSD condition bits. 
pppppp_ is the P-counter. 


On completion for uu = 01, word zero contains the information specified in Remark 
1, above. 

For uu = Ol and uu = 10, if the address specified in the low-order 30 bits of word 
two is out of bounds or if the exchange-package buffer is not entirely in SCM or 
LCM, execution is terminated with fatal error 230. 
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4. Introduction to I/O Requests 


A problem program issues an I/O request when it requires input or output to be performed 
by the system. User programs may request to read or write tape or disk files, or to read from 
or write to the PDP-10. I/O programs available only to the system include ones to write the 
drum, read the card reader, and write files to the online printer. 

You issue an I/O request by storing a description of the services desired in a 4-word 
block called an input-output descriptor (IOD). You store in the second word (word one) of your 
program the address, zeta, of the beginning of this 4-word IOD. Then you issue an exchange 
jump! to EEA, the resident executive program. (See LTSS-1, Sec. 3.10, for details about the 
exchange jump instruction.) FLOE gets control and examines word zero and word one of your 
program to determine what system-call or I/O service is required. Once you issue an IOD you 
should not modify it until the I/O completes. 


4.1 INPUT/OUTPUT CONNECTORS 


An IOD makes no direct reference to an I/O device. If a program could refer directly 
to an I/O device it would be possible for one program to interfere with another (by writing 
in the other’s disk file, for example). The interface between a program and an actual I/O device 
is called an input/output connector, or IOC. 

An IOC is a 3-word block located in the program’s minus words. Associated with every 
problem program is a block of 230, words which is outside the program’s memory bounds and 
thus is not accessible to the program. For convenience, this block of words immediately precedes 
the program in LCM. The block is thus called the program’s minus words, since it resides before 
word zero of the program. Forty-eight of the minus words are devoted to 16 three-word IOC’s. 
See Appendix B for more details on program minus words. 

For the problem programmer, the number of a particular IOC serves as a symbolic name 
for an I/O device. When a program desires to use an I/O device, e.g. a disk file or a tape, it 
must request the device from FLOE and specify an associated IOC number. If the device is available 
to the requesting program, FLOE stores information describing the device in the specified IOC. 
Thereafter, when the program needs to use the device, it refers in the IOD to this IOC number. 
The IOC thus serves as a map between the programmer’s logical names and the system’s absolute 
physical addresses and locations. 

Appendix C gives details about IOC format. 


4.2 EXAMPLES OF HOW TO ISSUE AN I/O REQUEST 


This section gives examples of two ways to issue an I/O request. We show first how to 
construct the IOD from the format information in Sec. 4.5, and how to issue the request in 
a Fortran program. Then we show an easier way to issue the same I/O request using ORDERLIB? 
subroutines. 

The I/O task we consider is to write 1000, words of information to disk, starting at 
(relative) disk location 0; the information is contained in a buffer named BUF. See Sec. 5.9 
for details of the disk-write I/O program. 
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The Hard Way. Figure 4 shows Fortran coding to issue this I/O request the hard way: 
the zeta words are set in lines 4 to 7. In lines 8 and 9, word I is set to the address of ZETA 
and an exchange instruction is issued. This is fairly straightforward. What is not obvious is how 
to fill in the zeta words so that the system takes the desired action. 


Line No. Fortran coding ZETA words (octal) 


1 ALL INTEGER 
code for 

2 ABSOLUTE ZERO (9), ONE (1) disk 10c 

3 DIMENSION ZETA (4), BUF (190@B) write (No.7 

4 ZETA == 5139907B .SHL. 36 9513 0007 9900 99090 9909 


“busy” 
bit 
ZETA(2) = 1 SHL. 59 4900 9000 9000 90909 9000 


word buffer 
count location 


ZETA(3) = (19000B .SHL. 27).UN. (.LOC.BUF) 9900 0090 9010 0006 uffe 
ZETA(4) = @ | 0909 9OOO OOOO GOGO GOOD 
ONE = .LOC.ZETA 

CALL Q8EXCH 


Fig. 4. Example of Fortran coding to issue a disk-write I/O request the hard way. 


Refer to Table 1 in Sec. 4.5. This table shows two possible formats for the four zeta 
words in an IOD. IOD’s for certain I/O tasks can be issued in either an 18-bit or a 19-bit format; 
this choice applies to reading or writing disk, drum, and odd-parity (binary) tape. For all other 
I/O tasks the 18-bit IOD format is used. Since we are requesting a disk-write operation, we must 
first choose which format to use. 

The 18-bit format was retained on the 7600 for compatibility with the 6600. The terms 
18-bit and 19-bit apply to the y, t, and i address fields (see Table 1). The i and ¢ fields have 
to do with chained I/O requests and will not concern us here. The y field specifies the size 
of the central memory buffer, i.e., the word count for the read or write operation. We will 
use the 19-bit format in our example. We suggest that you routinely use 19-bit IOD’s. 

To construct the zeta words we look at Table 1 and read the description of each bit 
field in Sec. 4.5, deciding if each field is needed to describe our particular I/O job. In this way 
we find that only the a and d fields in word zeta are needed. The a field identifies the I/O 
service being requested; in our case a = 0513,, the code for disk write. The 07 in the d field 
tells the system to use [OC number 7 in the program’s minus words. (We assume that a disk 
file has been created previously using IOC 7.) 

The only field we use in word zeta + 1 (i.e., ZETA(2) in the Fortran) is the u bit. This 
is termed the “active” or “busy” bit, because the system turns this bit off when the I/O job 
is completed. If you set this bit before issuing the IOD, you can query it to sense when the 
I/O finishes. 


ae 


LTSS-10 
Edition 5 
Sec. 4.2 to 4.3 Change 1: Oct. 11, 1973 


Word zeta + 2 contains the 19-bit word count (the y field) and the location of the buffer 
in the program from which the information will be written to disk (the z field). This address 
is represented in Fig. 4 by buffe (line 6). 

Finally, the fields in word zeta + 3 are not needed for our simple disk-write operation, 
so this word is set to zero. 

The Easy Way. Many people find it easier to issue I/O requests by calling the subroutines 
described in CIC Rept. M-027, FROSTCLICHE /| FROSTCALL / FROSTIO%‘. These subroutines 
are available on the ORDERLIB library.* Figure 5 shows the subroutine calls necessary to issue 
our disk-write request. 


Fortran coding 


ALL INTEGER 

DIMENSION BUF(19@QB) 

PARAMETER (NIOD = 16) 

COMMON / IOCOM / IEOP(NIOD), IOD(4,NIOD) 
CALL SETIO(7, 1900B, BUF, 7, 513B) 

CALL REIO (7, Q, 9) 


Fig. 5. Fortran coding to issue a disk-write I/O request the easy way, using entry points to the 
ORDERLIB routine FROSTIO. For details on this routine see Ref. 4. 


The statements in lines 3 and 4 give access to the common block, called IOCOM, used 
by FROSTIO for its “zeta words.’’ SETIO is used to set up our IOD, while the actual request 
is issued by a call to REIO. The 7’s in the first and fourth arguments to SETIO represent the 
IOD number and the IOC number, respectively; for convenience these numbers are usually set 
to the same value. The other arguments to SETIO specify the buffer size, the buffer location 
(i.e., variable name BUF), and the code for a disk-write request. 


4.3 CHAINED I/O REQUESTS 


I/O requests may be chained — that is, a number of requests may be submitted by issuing 
a single exchange jump instruction. There are two kinds of I/O chains: contingent and simultaneous. 

In contingent I/O chains each IOD can specify the location of another IOD to be submitted 
only after this I/O job completes. Contingent chains are also called i-field chains, since the location 

of the contingent IOD is given in the i field of an IOD (see Sec. 4.5). — 

| In simultaneous I/O chains (also called t-field chains; see Sec. 4.5) an IOD can specify 
the location of another IOD to be issued at the same time as this I/O job. Requests for the 
same device are processed in the order received. 

Up to 32 requests can be submitted in a chain. An I/O chain can be initiated by either 
the i or ¢ field, and can contain a mixture of i- and ft-field chains. See Sec. 4.5 for more details. 
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4.4 SCHEDULING I/O 


With several programs in the alternator loop at one time, conflicting demands arise for 
use of the I/O channels. The resident I/O programs, therefore, must schedule I/O jobs so that 
conflicts are avoided. 

For nondisk I/O the scheduling is very simple. For each nondisk channel the resident 
I/O maintains a list of jobs to be executed. Each list is processed in the order the jobs are 
submitted, except jobs for which magnetic tapes are currently rewinding. These jobs are temporarily 
bypassed in favor of jobs for other tapes until the rewind has been completed. 

This manner of scheduling would, however, lead to extremely inefficient use of the disks, 
since head motion is slow (50-150 msec). For this reason the list of jobs for each disk channel 
is ordered according to the head position where the job is to be started. Once the heads are 
at a given position, all the jobs for that head position are executed before the heads are moved. 
This has the effect of eliminating much unnecessary head motion. 


4.5 FORMAT OF AN INPUT/OUTPUT DESCRIPTOR (IOD) 


Table 1 shows .the format for 18-bit and 19-bit IOD’s. The meanings of the various bit 
fields are explained below. 


Table 1. 18-bit and 19-bit IOD formats (binary). 


18-Bit IOD Format 


Word zeta 

aqaaagqaaaaaaa =rrvephk-dddd_1------- ecee === CEtCECe. —LLECECELeecte 
Word zeta + 1 

u-ssssssssss bbbbbbbbbbbb — ------------ LNLLLGNLLNLL  NLLNLNNLLLNLX 


Word zeta + 2 
g9gggggggggg  g9g9ggggggIgIg “yyyyyyuuyYY yyy YY ~ 42422 BLBBEBBRBBBE 
Word zeta + 3 


SFFFFFFFFFFF = g----- titttt§ »=6ttititititit  n----- rom mmm 


19-Bit IOD Format 


Word zeta 

aaqaaalaaaaaa = rrvephk-dddd = -wwww---cece 8 ----- CELCEEE. “CEeeteceeice 
WOE Petts ------999999  gggg9gg99999 999999999999 

u-ssssssssss bbbbbbbbbbbb )__ “86 ere LLLLLLLLLLLL §— LLL LN LLL 
Word zeta + 2 

ee yyyyyyy yyyyyyyyyyyY teeheead “1-20-2223 BEBEBEREBBRS 
Word zeta + 3 

SIFFFFPFFFFF = Gennntttitt1t = =ttttitttitit == ne---mmmmm oem 
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I/O requests that can be issued with 19-bit IOD’s are requests to read (a = 0410) or 
write (0411) binary tape, read (0412) or write (0413) disk, or read (0414) or write (0415) drum. 
In Table 1 note the 1 bit in the a field of word zeta. This bit indicates that a 19-bit IOD 
is being used, since it implies that the a field will have a value between 0510, and O515,. The 
19-bit format is required if the i, ¢t, or y fields (see below) exceed 18 bits. We suggest that 
you routinely use the 19-bit format. 

The rest of this section describes the content, meaning, or use of the various bit fields 
in the IOD formats. 


a This field specifies the type of I/O job to be done. Each I/O program has a number 
associated with it. See the descriptions of the individual I/O programs in Secs. 5.1 to 
5.2 

b This field is incremented by one each time the IOD is completed. The I/O programs 


do not examine this field. A twelve-bit twos-complement addition is performed. 


C The [OD identification number assigned by the problem program is given in this 4-bit 
field. This number is used in connection with EEA call 10, the Give Up CPU until 
{/O Completes system call (see Sec. 3.5). When a problem program issues a Give Up 
CPU call, the program is not resumed until the completion of al] I/O requests whose 
cece (binary) IOD fields equal the cc (octal) field of the Give Up call. 


d This 4-bit field contains the IOC number. It indicates which of the 16 IOC’s in the 
problem programs minus words contains a description of the I/O device needed by 
this I/O request. 


e (System use only.) This bit is used in conjunction with the v bit (see below) to indicate 
that the address for the pattern disk write is in sectors. See Sec. 5.9 for more details. 


f This 12-bit field is used to return an error message. If the I/O operation was completely 
trouble-free the f field will contain a zero; otherwise an error number will be stored 
in it. The error numbers and their meanings are listed in Sec. 6.2. 


g This is a general-purpose field. If the I/O device is a disk, g contains the first-word 
address for the disk operation. If the device is not a disk, the meaning of the g field 
varies, and is described with each individual I/O program. For some I/O programs the 
g field is not used (a = 0414/0514,0415/0515, and 0520-2012); in these cases the 
problem program may use this field to store any desired information. 


h (System use only.) This bit is used with drum-write IOD’s. If kh = 1 the system accepts 
a 5-word IOD; the 5th word has the (octal) format: 


0000 xxxx 0000 yyyy zzzz 


where: xxxx is track number (12 bits); 
yyyy is sector number (12 bits); and 
zzzz is word number (12 bits). 


i This field is used for one of two purposes, depending on the j bit: 


(1) Ifj = O then i specifies the address of an interrupt routine that will be entered 
after this request completes. 

(2) If j = 1 then 7 specifies the address of a contingent IOD to be examined 
and processed only after this I/O request has completed. This allows you to 
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set up simple contingency of one I/O job on another without coding special 
interrupt routines. 


A maximum of 32 IOD’s can be chained together, either by such i-field chains, or 
by t-field chains (see below), or by a combination of the two. If the i field is void 
it specifies no action. | 


This bit is a flag to determine the meaning of the i field. If j} = 1 (and i is nonzero) 
then the 7 field is interpreted as the address of a contingent IOD. If j = O (and 7 is 
nonzero) then i is taken as the address of an interrupt routine. Once the interrupt 
routine for this IOD has been entered, all interrupts from other IOD’s (for this problem 
program) are inhibited until this interrupt completes. 


(System use only.) If k = 1 and the a field is between 2000 and 2012 (i.e., if this 
is an IOD to manipulate a tape, except to read or write one), then the second and 
third words of this IOD (words zeta + 1, zeta + 2) are used as an IOC for this request. 


If 7 = 1 and a = 2002 (Rewind and Unload and/or Disconnect Tape), then the tape 
unit is disconnected. If / = O the tape is rewound and unloaded and the tape unit 
is disconnected. 


This field is used for error contingencies. It has one of two meanings, depending on 
the n bit: 


(1) Ifn = O then m specifies the address of the program’s error-interrupt routine. 
This routine is entered if the IOD suffers an error. 

(2) Ifn = 1 then m specifies the location of an IOD to be examined and processed 
in case of an error. 


If the m field is void it specifies no action. 


This bit is a flag to determine the meaning of the m field. If n = 1 (and m is nonzero) 
then the m field is interpreted as the address of an error-interrupt routine. If n = O 
(and m is nonzero) then m is taken as the address of an IOD to be submitted in case 
this I/O request sustains an error. Once the error-interrupt routine (specified by the 
m field, n = 1) for this IOD has been entered, all interrupts from other IOD’s (for 


this problem program) are inhibited until this error-interrupt routine completes. 


(System use only.) This bit is used with drum-write I/O requests. If p = 1 the peripheral 
processing unit will not automatically verify the write. 


This field is only used with disk-write IOD’s. If the initial address and/or the final 
address of a disk write is not a multiple of 1000 (octal), the disk-write programs must 
read the partial sectors. If it is known that the unreferenced portions of the partial 
sectors need not be preserved, the reading step may be bypassed and the writing process 
speeded up. | | 


rr = OO means preserve the unreferenced portions of the first and last sectors 
specified in this disk-write IOD. 

rr = O1 means preserve the unreferenced portion of the first sector. 

rr = 10 means preserve the unreferenced portion of the last sector. 

rr = 11 means do not preserve the unreferenced portions of either the first or 
last sectors specified in this disk-write IOD. 
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This 10-bit field is reserved for programmer information. The information in the s field 
is returned in register AO upon normal completion (EOP interrupt) or error interrupt. 
This information could be used in a general interrupt routine. 


This field specifies the address of another IOD that is to be submitted at the same 
time as this one. A chain of IOD’s can thus be submitted by using the ¢ field. Such 
a simultaneous I/O chain differs from a contingent (i-field) chain in that the t-field 
chain is not necessarily ordered. Requests specifying the same device are processed in 
the order received. 

Any IOD chain can be initiated by either the 7 or the ¢t field, and can contain © 
a mixture of i- and f-field chains. 


This the active bit or “busy” bit. The wu bit is cleared by the I/O termination routine 
when the job is completed. You can set this bit before the IOD is submitted and query 
it to determine when the I/O finishes. 


This bit is used only with disk-write I/O requests. If »y = 1 the PPU writes a specified 
12-bit pattern in a specified disk file. There is a special format for the third word 
of the IOD in this case; see Sec. 5.9 for details. 


(System use only.) This 4-bit field, present only in the 19-bit IOD format, is used 
for card-reader and PDP-10 I/O requests. See Secs. 5.5, 5.12, and 5.13 for the use 
of the w field. 


This field may contain parameters returned by an I/O program to the problem program. 
See the descriptions of the individual I/O programs in Sec. 5. 


This field specifies the size of the central memory buffer. 


This field specifies the location of the central memory buffer. 


4.6 DIFFERENCE BETWEEN SEVEN-TRACK AND NINE-TRACK TAPES 


The difference between the seven-track and the nine-track tapes is that seven-track tapes 


can be written with either even or odd parity, while nine-track tapes are always odd parity. 
(The parity bit is the seventh bit on the seven-track tapes and the ninth bit on the nine-track 
tapes, and it is used for error checking.) Therefore, when reading or writing nine-track tapes, 
the even-parity tape IOD’s (A = 2, and A = 15) will imply conversion between 6-bit ASCII and 
FEBCDIC. The odd-parity-tape IOD’s will imply no-conversion on the data. 
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5. Input/Output Programs Available 


This section lists the 21 I/O programs available to the user and to the system. Some 
miscellaneous comments on the operation of several of these I/O packages are given immediately 
below. 

1. When a parity error is encountered in reading a tape, the PPU does not attempt 
to reread it. The tape is left positioned at the far side of the bad record. The 
information in the record is left in central memory. 

2. All the routines that read or write tape are oriented to single records. 

3. The tape-read routines read under record control. That is, the PPU reads a single 
record and transmits it to central memory. If the number of CPU words in the record 
exceeds the size of the buffer specified in the IOD, the PPU transmits as many words 
to central memory as will fit, and signals an error (0004) in the f field. 

4. If you try to perform any tape function involving forward motion in the 
approximately 20 feet of tape after the end-of-tape reflector, the end-of-tape error 
(f = 0010) will always result. If any other errors are present their numbers will be 
OR’d with this number. 


5.1 WRITE ONLINE PRINTER (SYSTEM ONLY) 


aaaa = QOO! (18-bit format) 


This program prints a packed-ASCII drum file on the online printer. The program is reserved 
for system use only. | | 
The z field contains the location of the four-word file identification. The y field contains 


the file size and the g field contains the starting address on drum. Field g must be a multiple 
of 128. 


5.2 READ EVEN-PARITY (BCD) TAPE 
aaaa = QOO2 (18-bit format) 


One entire record is read each time this I/O program is used. When the I/O job is completed, 
the g field and the x field of the IOD contain the number of 12-bit bytes (that is, the number 
of PPU words) that were transmitted to central memory. 

One caution is in order here. An end-of-file mark is treated as a record by the tape-read 
program; that is, if an end-of-file error is returned in the f field then no data was read. However, 
when an end of file is encountered the x field is not updated. If you simply check the x field 
to monitor the progress of a tape read you could be misled. 

Field y of the IOD specifies the buffer length. This length is interpreted as an upper 
limit on the number of words to be read. This upper limit will never be exceeded by the I/O 
program. 

If n represents the number of words actually in a record, one of three cases can result: 


1) If n = (field y) then 5 X a is stored in fields c and x. 
2) If n < (field y) then 5 X n is stored in fields g and x. 


3) If n > (field y) then 5 X x (field y) is stored in fields g and x. 


In case 3, an error is set in the f field indicating that the buffer was not large enough. 
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When reading 9-track tape, the high-order bit of field x will be set if the number of 
12-bit bytes transmitted is an even number and the last 6-bit byte was filled in by the hardware 
rather than being read from tape. 

If field g is not used, and field y specifies an odd number of 60-bit words, the last 
four bits will be lost. 


5.3 WRITE EVEN-PARITY (BCD) TAPE 


aaaa = OOI1S (18-bit format) 


If field g of the IOD is zero, the number of 60-bit words to be written is taken from 
field y. If field g is nonzero, the number of 12-bit words to be written is taken from field 
g. Field g must not exceed five times field y. 

See Table Al in Appendix A for the character conversion performed by this I/O program. 

If a bad spot is encountered the record is not automatically rewritten. You must check 
the f field for errors and take action appropnate to your needs. 

If the end-of-tape error is returned (f = OO10) then the record that was written is good. 

When writing 9-track tape, if the high-order bit of field g is set and field g specifies an 
even number of 12-bit bytes, the last 8-bit byte in the data field will not be written on tape. 

If field g is not used, and field y specifies an odd number of 60-bit words, the last four 
bits will be lost. 


5.4 SKIP TAPE RECORDS 


aaaa = OO16 (18-bit format) 
The action of this program is controlled by the g field, as follows: 


g = O000nnnn means skip n records backward. 
g = 4000nnnn means skip » records forward. 
g = 70------ means skip backward to end-of-file. 
g = 60------ means skip forward to end-of-file. 


The routine returns an error for all four cases if an end-of-file is encountered while skipping. 
The number of records actually skipped is returned in the x field of the IOD for the first two 
cases (g = OQOOOnnnn or g = 4000nnnN). 


9.5 READ CARD READER (SYSTEM ONLY) 


aaaa = OO17 (18-bit format) 


This program reads an ID card into the buffer specified by the z field if the w field 
is zero; or it reads a card deck into the drum file specified by the ¢ field if the w field is 
nonzero. The g field must be a multiple of 128. The program is reserved for system use only. 

The y field contains the maximum file size when the IOD is issued. This field will contain 
the actual file size encountered when the JOD is completed. The w field, when nonzero, specifies 
the file type: 
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w = 1 Packed ASCII. 

w = 3 Monitor squoze. 

4 Absolute. 

17 Bad ID Card. Deck will be read through the card reader. 


= = 
ol 


5.6 READ ODD-PARITY (BINARY) TAPE 


aaaa = 0410 (18-bit format) or aaaa = 0510 (19-bit format) 


One entire record is read each time this I/O program is used. When the I/O job is completed, 
the g and x fields of the IOD contain the number of 12-bit bytes (that is, the number of PPU 
words) that were transmitted to central memory. 

Field y of the IOD specifies the buffer length. This length is interpreted as an upper 
limit on the number of words to be read. This upper limit will never be exceeded by the I/O 
program. 

If n represents the number of words actually in a record, one of three cases results: 


1) If nm = (field y), then 5 X n is stored in fields g and s. 
2) If n < (field y), then 5 X nv is stored in fields g and x. 
3) If n > (field y), then 5 X x (field y) is stored in fields g and x. 


In case 3, an error is set in the f field indicating that the buffer was not large enough. 


When reading 9-track tape, the high-order bit of field x will be set if the number of 
12-bit bytes transmitted is an even number and the last 8-bit byte was filled in by the hardware 
rather than being read from tape. 

If field g is not used, and field y specifies an odd number of 60-bit words, the last 
four bits will be lost. | 


5.7 WRITE ODD-PARITY (BINARY) TAPE 


aaa = 0411 (18-bit format) or aaaa = 0511 (19-bit format) 


If field g of the IOD is zero, the number of 60-bit words to be written is taken from 
field y. If field g is nonzero, the number of 12-bit words to be written is taken from field 
g. Field g must not exceed five times field y. 

If a bad spot is encountered the record is not automatically rewritten. You must check 
the f field and take action appropriate to your needs. 

If the end-of-tape error (f = 0010) is returned, then the record that was written is good. 

When writing 9-track tape, if the high-order bit of field g is set and field g specifies 
an even number of 12-bit bytes, the last 8-bit byte in the data field will not be written on 
tape. | 

If field g is not used, and field y specifies an odd number of 60-bit words, the last 
four bits will be lost. 


5.8 READ DISK 


aqaaa = 0412 (18-bit format) or aaaa = 0512 (19-bit format) 


At the end of the operation, the x field contains the number of 60-bit words (the CPU 
word count) for this read. 
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If g is greater than the file size, error 4004 (out-of-bounds disk reference) is placed in 
the f field and the program is killed. 

If g is not greater than the file size but g + y is greater, then error 0020 (end of file) 
is placed in the f field and the number of words read (filesize - g) is placed in the x field). 
This number will be greater than zero but less than y. Data up to the end of the file are transmitted. 


5.9 WRITE DISK 


aaaa = 0413 (18-bit format) or aaaa = 0513 (19-bit format) 


If the v field is zero this I/O program writes specified data to disk. 

If g is greater than the file size, 4004 (out-of-bounds disk reference) is placed in the 
f field and the program is killed. 

If g is not greater than the file size but g + y is greater, 0020 (end of file) is placed 
in the f field and the number of words written (filesize - g) is placed in the x field. This number 
will be greater than zero but less than y. Data up to the end of the file are transmitted. 

If the » bit equals 1 the PPU writes a specified 12-bit pattern into any specified portion 
of the disk file. The third word of the IOD has a special format for this case, given by: 


“SE8ES8ESEES SEEESEESESSS PPPPPPPPPPPP —-VYVVVYVVVVYV VVVVVYVVVVVV), 
where: 


22...2 is the first disk word address for the write operation. 

pp...P is the 12-bit pattern to be written in the disk file. 

VyV.y is the number of 60-bit words to be filled with the desired disk pattern pp...p. 
This number must be a multiple of 1000,. 


This use of the disk write 1/O program allows you to clear all or part of a disk file, 
or to write a given pattern in the disk file, without creating a buffer in the problem program’s 
storage. 

If the e bit equals 1 the gg...g field in the IOD is taken as the first sector address for 
the write operation (system use only). 


5.10 READ DRUM (RESTRICTED USE) 


aaaa = 0414 (18-bit format) or aaaa = 0514 (19-bit format) 


Fields g and y must be multiples of 128. This program is for system use only. 
5.11 WRITE DRUM (RESTRICTED USE) 


aaaa = 0415 (18-bit format) or aaaa = O515 (19-bit format) 


Fields g and v must be multiples of 128. This program is for system use only. 
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5.12 READ PDP-10 


aaaa = 0516 (19-bit format) 


This program reads data from the PDP-10 file channel. 
The w bit is zero for data and one for control information. The PPU word count (12-bit 
words) is returned in the x field on completion of I/O job. 


5.13 WRITE PDP-10 


aaaa = Q517 (19-bit format) 


This program writes data on the PDP-10 file channel. 
The w field bit is zero for data and one for control information. 


5.14 READ TAPE-UNIT STATUS 


aaaa = 2000 (18-bit format) 


The tape-unit status is returned in the z field of the IOD. Multiple status states are logically 
added together; for example, z = OOOS indicates: 1) the tape unit is ready, 2) there is a ring 
in the tape, 3) the tape density is set to 200 bpi. 


--| Ready. 

---2 Busy. 

---4 Write enable (there is a ring in the tape). 
--]- Filemark. 

--2- Load point. 

--4- End of tape. 

-0- Density = 200 bpi. 

-l- Density = 556 bpi. 

-2-- Density = 800 bpi. 

-4-- Lost data. 

l-- End of operation. 

2--- Parity error. 

4—- Unit reserved by other channel. 


5.15 REWIND TAPE 
aqaaa = 2001 (18-bit format) 
5.16 REWIND AND UNLOAD AND/OR DISCONNECT TAPE 


aaaa = 2002 (18-bit format) 


If 7 = O the tape is rewound and unloaded, and the tape unit is disconnected from the 
problem program. If / = 1 the tape unit is disconnected, but the tape is neither rewound nor 
unloaded. 


=) [2 
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5.17 WRITE FILEMARK 
aaaa = 2003 (18-bit format) 
9.18 WRITE BLANK TAPE 


aaaa = 2004 (18-bit format) 


Six inches of blank tape are written. 
5.19 SET DENSITY TO 200 bpi 
aqaaa = 2010 (18-bit format) 
5.20 SET DENSITY TO 556 bpi 
aaaa = 2011 (18-bit format) 
5.21 SET DENSITY TO 800 bpi 


aqaaa = 2012 (18-bit format) 


5.22 SET DENSITY TO 1600 bpi 


aaaa = 2013 (18-bit format) 
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6. Error Indications 


6.1 STANDARD !1/O ERROR MESSAGES (f FIELD NUMBERS) 


The following values are placed in the f field of the IOD as the occasion demands: 


O000 = No errors. 

0001 = Device not ready, or not responding to status request. 
0002 = Parity error. 

0004 = Data exceeds programmer’s buffer. 
0010 = End of tape. 

0020 = End-of-file condition. 

0040 = Attempt to write file-protected tape. 
0100 = Channel failure. 

0200 = Lost data on tape record. 

0400 = Attempt to backspace over load point. 
1002 = Disk positioning error. 

2001 = Tape reserved by another channel. 


In the event of more than one error, the above numbers are logically added together. 


4001 = Channel number in IOC invalid. 

4002 = Out-of-bounds memory reference. 

4003 = Improper minus word. 

4004 = Out-of-bounds disk reference. 

4005 = Illegal IOD — zero word count requested. 

4006 = Illegal IOD — IOD and minus word do not check. 

4007 = Illegal IOD — ¢ field points to self. 

4010 = Illegal IOD — a field not valid. 

4020 = Channel is down. 

4040 = Attempt to write file-protected disk. 

4041 = Attempt to read higher protection level file. 

Note that all errors greater than 4000 are programmer errors. They are considered 
irremediable by FLOE and cause the program to be killed unconditionally. Thus the program 
need not examine the upper bit of the error field: it will always be zero if the program is running. 


6.2 MISCELLANEOUS PROBLEM PROGRAM ERROR MESSAGES 


The following codes may appear on the teletypewriter preceding the “‘all done’’ message. 
Any of these codes indicates that the problem program has been killed (that is, removed from 
the alternator loop) and placed back on disk. 

The formats of the error messages listed here are identical character-by-character to the 
messages put out by FLOE (except that upper and lower case are used here for clarity). 


6.2.1 PP Errors Not Involving an IOD 


200 Underflow 
201 Overflow 
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202 Indefinite 

203 Program range. P counter equals zero or a (QO) instruction has been issued. 
204 SCM direct range. P counter or SCM ref. equals or exceeds FLS. (not block copy) 
205 LCM direct range. LCM ref. equal or exceeds FLL. (not block copy) 
206 SCM block range. SCM ref. equal or exceeds FLS using block copy inst. 
207 LCM block range. LCM ref. equal or exceeds FLL using block copy inst. 
210 SCM parity 

211 LCM parity 

212 Illegal system call — word O bad or high order 6 bits of alpha bad 
213 Alpha out of bounds 

214 Beta out of bounds 

215 KOC request’ while in interrupt mode 

216 PP requested to return from interrupt when already at main level 

217 KOC” restart address points out of bounds 

220 I/O request (word1) points out of bounds 

221 Too many [ODs listed when adding PP to alternator loop 

222 IOD address out of bounds when adding PP to alternator loop 

223 PP called for too many exchange jump packages 

224 Invalid exchange package linkage 

225 FLS or FLL exceeds filesize-230B 

226 PP exchanged with word0=word1=0 

227 FLS exceeds 157760B or FLL + 230, exceeds 1414600B 

230 XJP address (word2) points out of bounds 

231 Static memory con. bounds fault. (See minus word 204 octal) 

232 Exit on breakpoint or step with word 2 = 0 

233 Return field (FLOE call) = 0 or points out of bounds 

234 Chain call field (hi order 30 bits of word QO) points out of bounds 

235 Channel no. in IOC and channel no. file is on, do not agree 

236 File is type data. Execution not allowed 

237 Teletype interrupt address points out of bounds (minus word 271 octal) 
240 Subordinate exchange package not correct (minus word 175B) 

241 Time interrupt P counter points out of bounds (minus word 173B) 

242 FLS > FLL 


6.2.2 Errors Involving an IOD 


300 Incorrect minus word. Illegal channel no. 

301 Requested non-existent I/O program. Illegal A field 

302 IOD and IOC word not compatible 

303 T field of IOD points out of bounds 

304 PP has submitted too many IODs (>31) 

305 PP has submitted too many IODs for one device (>15) 

306 PP error detected by slave PPU while executing an IOD. Examine F noe 
307 Address of contingent IOD is out of bounds 


* 
KOC means “knowledge of completion’”’; this is another term for EEA Call 10, Give Up CPU until 1/O Completes. See Sec. 3.3. 
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310 Interrupt address is out of bounds 
311 Zero disk length 

312 I/O out of bounds memory reference 
313 Out of bounds disk reference 

314 Zero word count requested 

315 T field points to self 

316 Attempt to write file protected disk 
317 Channel down 

320 Read access denied 


6.3 RECOVERING CONTROL AFTER A HARDWARE ERROR 


There are two ways a problem program may recover control after a hardware error: 


(1) If the PP’s word 2 is nonzero, control is returned to word 2 after the arithmetical 
errors, breakpoint, and step. 

(2) By setting minus word 174, you may selectively choose which hardware errors 
(excluding parity) you would like to recover control of. This takes precedence over 
the convention described in (1) above. Control is returned to word 2 if this word 
is nonzero and minus word 174 is set as follows: 


50435 04350 43504 3xxxx 


where xxxx is a mask that will be intersected with the condition bits in the PSD 
register (see Appendix E) after a hardware error. Control is returned to the problem 
program if the hardware error’s corresponding mask bit is nonzero. Otherwise, a fatal 
error results and the problem program is killed. 


For both cases (1) and (2), if the low-order 30 bits of word 2 contain a numbern = QO, 
then the current exchange package is copied beginning at location nm. Fatal error 230 results if 
n + 15 is out-of-bounds or is not entirely in SCM or LCM. Except after exit on step, the problem 
program’s word zero will contain: 

ccccp ppppp rrrrrrrrrr 


where: ccecc=condition bits in PSD. 


pppppp=P-counter. 
ry ...r=(previous contents). 
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Appendix A: ASCII and Tape BCD 


The Write Even-Parity (BCD) Tape I/O program converts the ASCII characters in the core 
memory to tape BCD format, as shown in Table Al. See Sec. 5.3 for details about this I/O 
program. 


Table Al. Character conversion done by the Write BCD Tape I/O program (a = 0015). 


ASCII Char- Tape ASCII Char- Tape ASCII Char- Tape ASCII Char- Tape 
code acter BCD code acter BDC code acter BCD code acter BCD 


OO (space) 20 


Ol 17 | A 61 Q 50 
02 ‘J a 2 B 62 R 51 
03 # 20° 3 C 63 S 22 
04 $ 53 4 D 64 T 23 
O5 % Ve 5 E 65 U 24 
06 & a2 6 F 66 V ZS 
Q7 14 7 G 67 W 26 
10 ( 34 8 H 70 x Zi 
id ) 74 9 If dA Y 30 
12 . 54 J 12 Z 3] 
13 + 60 ; K 13 [ 16 
14 33 << L 74 . 76 
15 - 40 = M 1» | 15 
16 ; 73 > N 76 t ay. 
17 / 21 ? O 17 = ie 
20 0 12 @ E 


“The 03 symbol (#) is written on tape as a space (blank,20B). When read, this 20B is read as a blank. Thus the original # symbol 
is lost. 
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Appendix B: Minus Words 


A block of 230, words, used for system functions, is associated with every problem 
program. These words (residing outside the PP’s memory bounds) are located immediately before 
word zero in LCM; thus they are called “minus words.” Table BI gives the use of these words. 

The last 35, of the minus words (words 173 to 230) are copied into SCM along with 
the PP. 


Table B1. Problem-program minus words as they reside in LCM. 


0 System IOD: 4 words. 
4 Number (of unprocessed I[OD’s): unprocessed IOD’s: 16 words. 
25 Number of issued [OD’s: number of CFIELD IOD’s: 16 words. 
45 Input/output connectors; 16 IOC's, three words per IOC: 48 words. 
125 Exchange-jump package pool: 8 words. 
135 Word zero first interrupt. 
136 Arithmetic exchange jump package: 16 words. 
156 Problem-program fatal error (high-order 12 bits) and location (low-order 48 bits). 
Loy Problem-program input/output charge (cycles). 
160 Input/output cycles used. 
16] PPU input/output charge (usec). 
162 Total SCM charge (psec). 
163 Adjust field length memory charge. 
164 Classification. 
165 Memory charge (usec). 
166 I/O idle clock. 
167 Accumulating total real CPU time (usec) logged for this PP. 
170 Accumulating total real I/O time (usec) logged for this PP. 


171 Controller interrupt. 

172 Accumulating total system-call time. 

173 Time interrupt. 

174 Mask for recovering control after a hardware error (see Sec. 6.4). 
175 Subroutine exchange package information. 

176 LCM slot time. 

Did Accumulating system call time. 


200 Accumulating LCM time. 

201 SCM slot time. 

202 Accumulating system call time. 

203 Accumulating SCM time. 

204 Static memory word (see Appendix D). 

205 Date last accounting. 

206 Seventeenth word. 

207 Eighteenth word. 

210 Executing exchange jump package: 16 words. 
230 Word zero of PP. 
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An input/output connector is the interface between a problem program and the I/O device 
it references. The PP’s minus words (see Appendix B) contain sixteen 3-word IOC’s, numbered 
Q through 15. IOC O begins at minus word 45,. An IOC is filled in by the system on a Create 
or Open system call; an IOC is cleared by the system on a Close or Destroy system call. 

An IOC has the following format (binary): 


aqaaaadaaaaaa 


deeeeefffegg 


ad.. 


bb.. 


CC. 


a 


(60 bits) 


.b 
(30 bits) 


C 


(30 bits) 


eeeee 


Sif 


§8§ 


hh.. 


lil 


A 
(12 bits) 


adaaadaaaaaaa aqaaaaaaaaaaa = dadaaaadaaaaaa 
bbbbbbbbbbbb bbbbbbbbbbbb bbbbbbccccec ccceccccccce 
hhhhhhhhhhhh _ iiijjjkkKklll Willmmmmmm mmmmnmmnmmmmmm 


aadaadaadaaadaada 
CCCCCCCCCCCC 


is the right-adjusted name of the I/O device. Ten characters maximum 
are allowed for a disk file, six characters for a tape. 


is the first-word address (given as a sector address) of a disk file (blank | 
if the I/O device is a tape), including the 512-word ID sector. 


is the number of words in a disk file (blank if the I/O device is a 


tape), including the 512-word ID sector. 


is the public file bit: 
d = O Private file. 
d = 1 Public file. 


is the logical I/O unit number. 
cecee = 1. to. 14, Disk. 


eeeee = Il, Drum. 
eeeee = 12, dd80A. 
eeeee = 14, Tape. 

gecee = 1D, PDP-10 
eceee = 24, Card reader. 
eeeee = 25, Printer. 


is the pool-file flag: 
fff = 9 Not a pool file. 
fff = 1 Pool file. 


is the type of I/O unit: 


geg = O Disk. 
geg = 1 Tape. 
gee = 3 dd80A. 


geg = 7 Drum. 


is a pointer to the file-entry index (for disk IOC’s), or the tape unit 
designator (for tape [OC’s). The hf field is void for other IOC’s. 
Tape IOC Tape unit, in the form -----xxxnnn, where xxx is 


the tape bank (O or 1) and nmn is the tape number 


(O to 7). 


Disk IOC Pointer to the file-index entry; all 12 bits may be 


used. 


is the type of disk file: 


270: 


Appendix C 


i 


kkk 


(9 bits) 


(18 bits) 


Read-write. 
Read-only. 
Data. 
Execute-only. 


is the protection level: 


Not classified. 
Unclassified. 


Protect as restricted data. 
ADP or official use only. 


(Reserved. ) 
Secret. 
(Reserved. ) 
System. 


OQ Read access permitted. 


iii = | 
iii = 2 
lii = 3 
iii = 4 
jij = 0 
ae 
jij = 2 
3 
a 
ez 
jij = 6 
| 
is the access flag: 
kkk = 
kkk = 


1 Read access denied. 


is the descriptor block pointer. 
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is the count of I/O references. Each I/O request increments this field 


by one. 
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Appendix D: Static Memory Convention 


A problem program may be organized in such a way that a portion of its image is unchanged 
by computation. This read-only portion does not need to be copied from SCM to LCM. This 
convention results in a savings of block-copy time. 

To use the state memory convention, set up minus word 230, (i.e., RAL-24) in the format: 


OO00x xxxxx OOOOy yyyyy 


where: x is the beginning address of the read-only portion. 
y is the beginning address of the second section of the read-write portion. 


The addresses x and y are checked for bounds fault on an end-of-load from disk. If either 
is out-of-bounds, a fatal error 231 results. 

If minus word 204 is zero, it specifies that the entire problem program image is to be 
copied from SCM to LCM. 
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Appendix E: CPU Exchange Package 
and Program Status Designator Register (PSD) 


Figure El and Table El show the formats of a problem program’s CPU exchange package 
and of the PSD register. | 


SCM location n 


m= m= DO CON WA Nn BW PO — 


NRPARBASATBAHEARRBATSB 
t++etttetetetet+et+tt +t 


Fig. El. CPU exchange package. 
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Table El. The program status designator (PSD) register. 


Bit No. Program status 


Condition flags 


0 Underflow 
| Overflow 
2 Indefinite 
3 Step 
4, Breakpoint 
5 Program range 
6 SCM direct range 
7 LCM direct range 
8 SCM block range 
9 LCM block range 
10 SCM parity 
1] LCM parity 
Mode flags 
ea Underflow 
13 Overflow 
14 Indefinite 
15 | Step 
16 Monitor 
17 Exit 
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Appendix F: Problem-Program State Codes 


Problem-program states are often defined by 3-letter codes rather than numbers. The 
correlation between codes and state numbers is as shown in Table Fl. 


Table Fl. Problem-program state codes. 


State Code Meaning 
11 MEM Waiting for LCM space. 
12 TPE Waiting for tape assignment. 
14 XMT Waiting to send a message to teletypewriter. 
16 RCV Waiting to receive a message from controller. 
22 Ze Waiting to send a message to RJET. 
23 23 Waiting to get a message from RJET. 
°) SUS Suspended at program’s own request. 
32 PDP Waiting for a file-transport message packet from 
PDP-10. 
Ad 44 Waiting to send a message to the PDP-10. 
46 46 Waiting to send a message to the operator’s 
| teletypewriter. 
56 56 Waiting for controller to process TTY interrupt. 
70-77 FIN Program execution finished. 
1-10 RUN Program is in LCM. 
Vo 394339 davasie. 


-84- ty GPO 792-346 


LTSS-10 
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Absolute file 69 Charges 
ABSOLUTE statement 3 for system call 1 
Access general purpose 39 
code 7 Claimed time 18 
denied 11 Clock 
Accessing files 1 master 45 
Account microsecond 17, 45 
number 21 Close 38 
user 34 Collector 50 
Adjust Program Field Length 23 Committed time 18 
ADP 12 Compatibility of 7600 with 6600 61 
alpha | Completion, normal 14 
ALPHA 3 Communicating 
ASCII code vs. BCD tape 77 controllees, controllers 1 
Bank account 39 terminal devices | 
BCD Concentrator 50, 52 
read even-parity tape 67 Confidential 12 
tape 77 Contingent I/O chains 62 
write even-parity tape 68, 77 Control resumes 5 
beta Control Message Bypasses 44 
definition 1 Controllee 1 
= 2222220222 22222eL222 29, 39 Controllee 
= VIITMWIWTIVITIVATTITVTT717 «S29, 33 give access 19 
BETA 3-4 recall access 19 
Bit-and-byte manipulations 2 Controller 1 
Blank tape, write 72 CPU 
Breakpoint address 58 exchange package 82 
Bypass give up — next turn 56 
input 26, 44 give up until I/O completes 57 
output 26, 44 Create 6 
Card reader Create a disk file 3 
create 7 Cut Back File Length 22 
destroy 10 Data 11 
file types 68 Dead-start flag 41 
teletypewriter 15 Delimiters, symbol 32, 33 
Chained I/O requests 62 Density 
Chains set 200 bpi 71-72 
contingent 62 set 556 bpi 71-72 
i-field 62 set 800 bpi 71-72 
t-field 62 set 1600 bpi 71-72 
simultaneous 62 Descriptor block 41 
Change File Name, Program Name, Destroy 9 


Account Number 21 
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Disk file Execute-only 
clear pattern 70 drop file 8 
write pattern 70 open 11 
Disk Fatal error 2 
channel 63 Field length, large core (See FLL) 
map 10 Field length, small core (See FLS) 
read 69 File 
swapping 54 absolute 69 
write 68 accessing | 
Donation of time 46 drop 6, 8 
Drop file duplicate 6 
problem-program 6 index 7, 10 
execute-only 8 length 22 
Drum monitor squoze 69 
create 7 name 
destroy 10 change 21 
read 70 | legitimate 14 
write 70 packed ASCII 69 
Drum-file index 17 political 11 
Duplicate file 6 private 11 
EEA public 11 
calls to 56 read-only 11 
error exit address 55 read-write 11 
resident executive program | transport 11, 48, 50 
End-of-message 25 Filemark, write 72 
End-of-tape FILENAME 
error 67-68 disk file 3 
reflector 67 File pool access keys, 18, 47 
mark 67 Flags 
Error condition 83 
fatal 2 mode 83 
f-field numbers 73 FLL 23, 55 
hardware, recovering control 75 Floating-point 34 
indications 73 FLOE 
involving an IOD 75 calls to 6 
1/0 73 definition 1 
messages 73 FLS 23, 55 
not involving an JOD 73 Format 
problem program 73 word | 
return 5 FROSTCALL 4 
Even-parity (BCD) tape FROSTCLICHE 4 
read 67 FROSTCLICHE/FROSTCALL/FROSTIO 62 
write 68 FROSTIO 4 
Exchange jump 1 General Purpose 39 
Exchange package 9, 58, 82 Get a Clock Reading 
Exchange Package Manipulation 58 EEA 56 
FLOE 45 
-26- 


wx GPO 792-983 


Get a Message from Device 50 
Get a Message from the Controller 28 
Get a Message from the Controllee 29 
Get a System Table 16 
Get Symbols from the Controller 30 
Get Symbols from the Controllee 32 
Give Files to Other Users 14 
Give Up CPU until I/O Completes 57 
Give Up CPU — Next Turn 56 
Give Tape Access to Controllee 19 
GOBCOM 4 
Hardware error, recovering control 75 
Head position 63 
How to issue an I/O request 60 
ID number 17 _ 
i-field chains 62, 65 
Inhibited from using system 18 
Initial time of repository group 17 
Initialize or Disconnect a Controllee 33 
Input bypass 26, 44 
Input/output 

connector 3, 60, 79 

descriptor 63, 74 

optimization 63 

programs available 67 

requests 60, 62 
IOC (See input/output connector) 
IOD (See input/output descriptor) 
Interrupt Controller for a Message or 

After a Time Interval 52 
KOC “Knowledge of completion” 57 
Large-core field length 36 
Large-core memory 

adjust field length 23 

definition | 

loaded into 12 

minus words 78 
Last message 37 
LCM (See large-core memory) 
Legitimate file name 14 
Levels, program 24 
Line printer 7 
Load size 36, 39 
Logical tape unit 8 
Machine 

designation 46 

identification 45 


Machine-device identification 49 
Memory, static convention 8&1 
Message 

header 49 

last 37 

return to PP buffer 29 
Minus words 39, 40, 60, 78 
Monitor squoze 69 
Name of disk file 7 
NEA (See normal exit address) 
Nine-track tape 7, 10 
Nondisk equipment 9 
Normal completion 14 
Normal exchange exit | 
Normal exit address 55 
Not classified 12 
Odd-parity (binary) tape 

read 68 

write 68 
Online printer, write 67 
Open 10 
Operator 

console teletypewriter 15 

message to 7 
Optimization, I/O 63 
Options of calls 2 
ORDERLIB 2, 60 
Output, bypass 26, 44 
Out-of-bounds, address references 2 
Overhead account code 47 
Over-subscription prevent option 47 
P-counter 55 
Packed ASCII 69 
PARD 12 
Parity error 13 
Pattern, disk file 

clear 70 

write 70 
PDP-10 

read 71] 

write 71 
Percentage of repository 47 
Political file 7, 11 
Pool bosses 39 
Pool file index(s) 16 
Positioning error 13 
Priority 17, 34, 39 
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Priority-weighted charged time 17 
Private file 11 
Problem name 21 
Problem program 
error messages 73 
introduction to | 
Program name 41 
Program status designator (PSD) 
register 55, 82-83 
Protection level 
create 8 
not classified 12 
unclassified 12 
PARD 12 
ADP 12 
confidential 12 
secret 12 
system 12 
PSD (See program status designator) 
Public file 7, 11 
Queue 42 
Q8EXCH 3-4 
RAL (See relative address, large 
core) 
RAS (See relative address, small 
core) 
Read-only 11] 
Read-only file 11 
Read-write file 11 
Read-write 11 
Relative address, large core 55 
Relative address, small core 55 
Release I/O devices 9 
Repository 
table 16 
group 16 
initial time of 17 
Reserve space 6 
Resident executive program | 
Restarts 43 
Restrictions, 
number of calls | 
Return from an Interrupt Routine 58 
RJET 48, 50 
RJET output, user No. OOOOO02 15 
Run a Subordinate Job within this 
Problem Program’s Field Length 54 
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Scheduling [/O 63 
SCM (See small-core memory) 
Secret 12 
Send a Message to Device 48 
Send a Message to the Controller 24 
Send a Message to or from a Control 
Teletypewriter 15 
Seven-track tape 7, 10 
Simultaneous I/O chains 62 
Small-core memory 
adjust field length 23 
definition | 
field length 36 
Standby priority 40 
Start up Controllee With or Without a 
Message 26 
State codes, problem program 84 
Static memory convention 8] 
Step-mode flag 58 
Suffix 33, 40, 
Suspend and Automatically Restart 43 


Suspend 
mode 28 
option 27 


Swapping, disk 54 
Symbol delimiters 32, 33 
System call 
chained 1, 4 
completion 2] 
definition | 
how to issue 1-2 
System protection level 12 
System table 16 
Table, system 16 
Tape 
access to controllee 19 
create 6 
density 7] 
disconnect 71] 
drives 6 
even-parity (BCD) 67-68 
nine-track 66 
odd-parity (binary) 69 
records, skip 68 
rewind 7] 
seven-track 66 
unload 71] 


Tape unit 

create 8 

read status 71 
Tape-vault number 7 
Teletypewriter 25, 42 
Termination point 13 
This Problem Program is Finished 13 
Time 

claimed 18 

committed 18 

limit 39 
Time-limit-notify option 34 
t-field chains 62 
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TMDS 48, 50 
Unclassified 12 
User 
account 34 
directory 16 
User had no files 10 
User No. 000002 15 
User-1 6, 14 
Write even-parity (BCD) tape 
I/O program 68, 77 
Word zero | 
Zero word | 
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the United States Government. Neither the United States nor 
the United States Atomic Energy Commission, nor any of their 
employees, nor any of their contractors, subcontractors, or their 
employees, makes any warranty, express or implied, or assumes 
any legal ability or responsibility for the accuracy, completeness 
or usefulness of any information, apparatus, product or process 
disclosed, or represents that its use would not infringe privately- 
owned rights.” 
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